home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1994 November / Cd Ware (Nro. 2) - Epimundo.iso / DOS / CM / MYCOMM2.ZIP / MYCOMM.DOC < prev    next >
Encoding:
Text File  |  1994-06-21  |  199.7 KB  |  4,743 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 MyComm  Version 2.23
  10.                          Unregistered Version Documentation
  11.                                 Printed June 21, 1994
  12.                       Copyright (c) 1992 - 1994 - Ken Dorshimer
  13.                                  All Rights Reserved
  14.  
  15.  
  16.  
  17.  
  18.             MyComm is NOT Public Domain or free software.  The MyComm
  19.           software, support files, and documentation are Copyright (c) 1992
  20.           - 1994 Ken Dorshimer, all rights reserved.
  21.  
  22.             MyComm is being marketed under the "Shareware" concept.  You
  23.           may use MyComm for a 30 day evaluation period to determine its
  24.           usefulness in your particular application.  After the 30 day
  25.           evaluation period you must register MyComm if you continue to use
  26.           it.
  27.  
  28.             Registration is as follows:
  29.  
  30.               Send $25 (twenty five U.S. dollars drawn on a U.S. bank),
  31.           plus $2 ($3 outside of U.S.) shipping and handling to:
  32.  
  33.                Ken Dorshimer
  34.                P.O. Box 5143
  35.                Belmont, Ca. 94002
  36.  
  37.             (Please send check or money order, do not send cash.  People
  38.           who want to order MyComm from outside the U.S. should obtain a
  39.           money order in U.S. dollars from a local bank.)
  40.  
  41.             For your convenience there is a file called ORDER.FRM which is
  42.           an order form for MyComm.  An order form is also included in
  43.           Appendix F of this documentation.  Please note that if you
  44.           downloaded MyComm from a BBS that charges a subscription fee,
  45.           obtained a copy of MyComm from a "shareware disk copying"
  46.           service, or CD ROM library the registration fee for MyComm is not
  47.           paid for or collected by those services!
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.           1.0  Introduction to MyComm                                1
  56.               1.1  Registration and Licensing                        2
  57.               1.2  Disclaimer and Warranty                           5
  58.               1.3  Definitions, Acronyms                             5
  59.               1.4  General System Requirements                       6
  60.               1.5  MyComm Files                                      7
  61.               1.6  MyComm Support and Technical Assistance           8
  62.           2.0  MyComm Installation and Running                       8
  63.               2.1  System Requirements                               8
  64.               2.2  MyComm Installation Instructions                  9
  65.               2.3  Running MyComm                                   11
  66.               2.4  Command Line Parameters                          12
  67.                   2.4.1 Join Script                                 12
  68.                   2.4.2 Dial Entries  (Registered version only)     12
  69.                   2.4.3 Timed Start  (Registered version only)      13
  70.           3.0  MyComm Screens and Menus                             13
  71.               3.1  Terminal Screen                                  14
  72.               3.2  Help Menu - F1                                   14
  73.               3.3  Chat Mode - Alt A                                15
  74.               3.4  Send Break - Alt B                               16
  75.               3.5  Clear the Screen - Alt C                         16
  76.               3.6  Dialing Functions - Alt D                        16
  77.                   3.6.1  Add Phone List Item                        17
  78.                   3.6.2  Edit Phone List Item Screen                17
  79.                       3.6.2.1  Name                                 17
  80.                       3.6.2.2  Number                               18
  81.                       3.6.2.3  Baud Rate                            18
  82.                       3.6.2.4  Data Bits                            18
  83.                       3.6.2.5  Data Parity                          18
  84.                       3.6.2.6  Stop Bits                            18
  85.                       3.6.2.7  Default Protocol                     19
  86.                       3.6.2.8  Dial Prefix                          19
  87.                       3.6.2.9  Logon Name                           19
  88.                       3.6.2.10 Password                             19
  89.                       3.6.2.11 Terminal Type                        20
  90.                       3.6.2.12 Local Echo                           20
  91.                       3.6.2.13 Received BS (BackSpace) Destructive  20
  92.                       3.6.2.14 BS Key Sends BS or DELete            20
  93.                       3.6.2.15 Strip Hi Bits                        21
  94.                       3.6.2.16 Add LF after incoming CR             21
  95.                       3.6.2.17 Clear last date called               21
  96.                       3.6.2.18 Script                               21
  97.                       3.6.2.19 Save Changes                         21
  98.                   3.6.3  Delete an Item                             22
  99.                   3.6.4  Call Numbers (Dial)                        22
  100.                   3.6.5  Phone Item Info Screen                     23
  101.                   3.6.6  Manual Dial Screen                         23
  102.                   3.6.7  Mark Phone List Items                      24
  103.                   3.6.8  Find Phone List Items                      24
  104.                   3.6.9  Load Phone List Screen                     24
  105.                   3.6.10 Sort Phone List                            24
  106.                   3.6.11 Move Phone List Item                       25
  107.                   3.6.12 Print Phone List                           25
  108.  
  109.                                          i
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.               3.7  Local Echo On/Off - Alt E                        25
  117.               3.8  Line Feeds On/Off - Alt F                        25
  118.               3.9  Hang Up Modem - Alt H                            26
  119.               3.10  Send Modem Initialization Strings - Alt I       26
  120.               3.11 Join Script - Alt J                              26
  121.               3.12 Present Line Status - Alt L                      26
  122.               3.13 Scroll Back - Alt K                              27
  123.               3.14 Manual Dial - Alt M                              27
  124.               3.15 Outside to DOS - Alt O                           28
  125.               3.16 Change Port Parameters - Alt P                   28
  126.               3.17 Quick Re-Dial - Alt Q                            29
  127.               3.18 Run External Program - Alt R                     29
  128.               3.19 Session Capture On/Off/Pause - Alt S             29
  129.               3.20 Terminal Emulation - Alt T                       30
  130.               3.21 Update Configuration - Alt U                     30
  131.                   3.21.1  Modem Setup Screen                        30
  132.                       3.21.1.1  COM Port                            31
  133.                       3.21.1.2  Modem Initialization String         32
  134.                       3.21.1.3  Modem Attention String              32
  135.                       3.21.1.4  Modem Hang Up String                32
  136.                       3.21.1.5  Modem Answer String                 33
  137.                       3.21.1.6  Modem Cancel Dial String            33
  138.                       3.21.1.7  Modem Dial Suffix String            33
  139.                       3.21.1.8  Dialing Wait Time                   33
  140.                       3.21.1.9  Pause Between Calls                 34
  141.                       3.21.1.10 Local Echo on by Default            34
  142.                       3.21.1.11 Use DTR to Hang Up Modem            34
  143.                       3.21.1.12 Use XON/XOFF Flow Control           34
  144.                       3.21.1.13 Use CTS/RTS Flow Control            35
  145.                       3.21.1.14 Use DSR/DTR Flow Control            35
  146.                       3.21.1.15 Dialing Prefixes                    35
  147.                       3.21.1.16 Connect Strings                     36
  148.                   3.21.2  Paths Setup                               36
  149.                       3.21.2.1  Download Directory                  37
  150.                       3.21.2.2  Upload Directory                    37
  151.                       3.21.2.3  Path\File for Screen Capture        37
  152.                       3.21.2.4  Session Capture Path\File           37
  153.                       3.21.2.5  Phone File Path\File                37
  154.                       3.21.2.6  Editor Path\Filename                37
  155.                       3.21.2.7  External Programs Path\Filename     38
  156.                   3.21.3  Protocols Setup                           38
  157.                       3.21.3.1  ASCII Transfers Setup               38
  158.                           3.21.3.1.1  Strip High Bits               39
  159.                           3.21.3.1.2  Remote Abort Char             39
  160.                           3.21.3.1.3  CR Translation                39
  161.                           3.21.3.1.4  LF Translation                40
  162.                           3.21.3.1.5  Local Echo On During Uploads  40
  163.                           3.21.3.1.6  Expand Blank Lines to Spaces  40
  164.                           3.21.3.1.7  Line Pace Time                40
  165.                           3.21.3.1.8  Character Pace Time           40
  166.                           3.21.3.1.9  Pacing Char                   41
  167.                       3.21.3.2  Zmodem Transfers Setup              41
  168.                           3.21.3.2.1  Zmodem 32 Bit CRC             41
  169.                           3.21.3.2.2  Zmodem Auto Download Feature  41
  170.  
  171.                                          ii
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                           3.21.3.2.3  Zmodem Send Crash Recovery    41
  179.                           3.21.3.2.4  Zmodem Receive Crash Recovery 42
  180.                       3.21.3.3  Kermit Transfers Setup              42
  181.                       3.21.3.4  External Protocols Setup            43
  182.                   3.21.4  Miscellaneous Options Setup               44
  183.                       3.21.4.1  Screen Background Color             45
  184.                       3.21.4.2  Screen Text Color                   45
  185.                       3.21.4.3  Date Format Style                   45
  186.                       3.21.4.4  12 or 24 Hour Time Format           45
  187.                       3.21.4.5  Make Noise When Calls Connect       46
  188.                       3.21.4.6  Make Noise After File Transfers     46
  189.                       3.21.4.7  Use Direct Video                    46
  190.                       3.21.4.8  Your Name for sign on               46
  191.                       3.21.4.9  Password for sign on                46
  192.                       3.21.4.10 Clever quip for TagLine             47
  193.                       3.21.4.11 Guess Up/Download Filename          47
  194.                   3.21.5  COM Port Addresses                        47
  195.                   3.21.6  Restore to Defaults                       48
  196.                   3.21.7  Save Setup                                48
  197.               3.22 Send Screen to File - Alt W                      48
  198.               3.23 Exit MyComm - Alt X                              48
  199.               3.24 Help Screen - F1                                 48
  200.               3.25 Send Name - F2                                   49
  201.               3.26 Send Password - F3                               49
  202.               3.27 Send Tagline  - F4                               49
  203.               3.28 Transferring Files                               49
  204.                   3.28.1  Starting a File Transfer                  50
  205.                   3.28.2  File Transfer Hints                       53
  206.                   3.28.3  Download Files - PgDn                     53
  207.                   3.28.4  UpLoad Files - PgUp                       53
  208.                   3.28.5  ASCII File Transfers                      53
  209.                   3.28.6  SEAlink Derived File Transfers            54
  210.                   3.28.7  Xmodem File Transfers                     54
  211.                   3.28.8  1K-Xmodem File Transfers                  54
  212.                   3.28.9  Ymodem Batch File Transfers               55
  213.                   3.28.10  Ymodem-G Batch File Transfers            55
  214.                   3.28.11 Zmodem File Transfers                     55
  215.                   3.28.12 Kermit File Transfers                     56
  216.                   3.28.13 External Protocol File Transfers          56
  217.                   3.28.14 MyComm as a Host                          56
  218.           Appendix A - MyComm Command Summary                       58
  219.           Appendix B - MyComm Line Editing Functions                59
  220.           Appendix C - Terminal Emulation                           60
  221.               1.0  TTY Terminal Emulation                           60
  222.               2.0  ANSI Terminal Emulation                          60
  223.               3.0  VT-52 and VT-100 Terminal Emulation              61
  224.               4.0  3270 Terminal Emulation                          62
  225.           Appendix D - Troubleshooting                              63
  226.           Appendix E - MyComm Script Language                       67
  227.               1.0  Script Language Introduction                     67
  228.                   1.2  Creating a Script                            67
  229.               2.0  Script Language                                  68
  230.                   2.1  Special Script Characters                    69
  231.                   2.2  Script Functions                             69
  232.  
  233.                                          iii
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.                       2.2.1  Labels                                 69
  241.                       2.2.2  WAITFOR()                              70
  242.                       2.2.3  XMIT()                                 70
  243.                       2.2.4  GOTO()                                 70
  244.                       2.2.5  SETFLAG()                              70
  245.                       2.2.6  INCFLAG()                              71
  246.                       2.2.7  DECFLAG()                              71
  247.                       2.2.8  IFFLAG()                               71
  248.                       2.2.9  IFSCAN()                               71
  249.                       2.2.10 SENDNAME()                             72
  250.                       2.2.11 SENDPASS()                             72
  251.                       2.2.12 SENDFILE()                             72
  252.                       2.2.13 RECVFILE()                             73
  253.                       2.2.14 SNDBREAK()                             74
  254.                       2.2.15 ALARM()                                74
  255.                       2.2.16 PAUSE()                                74
  256.                       2.2.17 HANGUP()                               74
  257.                       2.2.18 IGNORECD()                             74
  258.                       2.2.19 SETSTR()                               75
  259.                       2.2.20 GOSUB()                                75
  260.                       2.2.21 RETURN()                               75
  261.                       2.2.22 EXIT()                                 75
  262.                       2.2.23 QUIT()                                 76
  263.                       2.2.24 COMPSTR()                              76
  264.                       2.2.25 LOCLECHO()                             76
  265.                       2.2.26 IF()                                   76
  266.                       2.2.27 PORTGET()                              77
  267.               3.0  Script Syntax Checker                            78
  268.               4.0  Script Sample                                    79
  269.           Appendix F - MyComm Order Form                            80
  270.           Appendix G - MyComm Bug Report Form                       81
  271.           Appendix H - Planned Modifications and Upgrades           82
  272.           Appendix I - MyComm Revision History                      83
  273.           Appendix J - Control Characters                           84
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.                                          iv
  284.  
  285.  
  286.           MyComm Version 2.23 Documentation                 Page 1
  287.  
  288.  
  289.  
  290.  
  291.           1.0  Introduction to MyComm
  292.  
  293.             MyComm is a small, yet powerful, data communications program
  294.           designed to enable users to access public bulletin board systems
  295.           (BBS's) and other telecommunication services.  MyComm is designed
  296.           to run under the PC/MS-DOS operating system using DOS version 3.3
  297.           or higher.  MyComm has a variety of built in file transfer
  298.           protocols including Zmodem, Xmodem, Xmodem-1K, Ymodem Batch,
  299.           Ymodem-G Batch, SEAlink, Kermit, and of course ASCII.  There are
  300.           also slots to install up to six external file transfer protocols.
  301.  
  302.             The driving principle behind MyComm is to provide a reliable,
  303.           powerful, and versatile communications package which is easy to
  304.           use, and small in size.  Great care has been taken to optimize
  305.           MyComm for operating speed and to keep the executable code size
  306.           small so that it takes up less of your valuable disk space.
  307.           MyComm is designed to be easy to use for both novice and
  308.           experienced users, and employs a menu system that is friendly and
  309.           simple to navigate through.
  310.  
  311.           MyComm features include:
  312.  
  313.           ■    A full featured communications package which is small in
  314.                size.
  315.  
  316.           ■    Wide variety of popular file transfer protocols.
  317.  
  318.           ■    Powerful, yet easy to use "script" language.
  319.  
  320.           ■    Small code size which will run with approximately 200K of
  321.                RAM.
  322.  
  323.           ■    Intelligent ANSI character translation which filters out
  324.                potentially harmful ANSI keyboard re-mapping sequences.
  325.  
  326.           ■    Intelligent DOS shell function that brings you back to the
  327.                disk drive and directory that you started from when you
  328.                return to MyComm.
  329.  
  330.           ■    Detection and use of the 16550 UART and FIFO buffers.
  331.  
  332.           ■    Locates program and configuration files no matter what
  333.                directory MyComm is started from (DOS 3.0 or greater).
  334.  
  335.           ■    Support for COM ports 1 through 8.
  336.  
  337.           ■    Simple, and easy to use.  Some may even call it "fun"!
  338.  
  339.  
  340.           MyComm Version 2.23 Documentation                 Page 2
  341.  
  342.  
  343.  
  344.           1.1  Registration and Licensing
  345.  
  346.             MyComm is NOT Public Domain or free software.  The MyComm
  347.           software, support files, and documentation are Copyright (c) 1992
  348.           - 1994 Ken Dorshimer, all rights reserved.
  349.  
  350.             MyComm is being marketed under the "Shareware" concept.  You
  351.           may use MyComm for a 30 day evaluation period to determine its
  352.           usefulness in your particular application.  After the 30 day
  353.           evaluation period you must register MyComm if you decide to
  354.           continue to use it.
  355.  
  356.             Registration is as follows:
  357.  
  358.               Send $25 (twenty five U.S. dollars drawn on a U.S. bank),
  359.           plus $2 ($3 outside of U.S.) shipping and handling to:
  360.  
  361.                Ken Dorshimer
  362.                P.O. Box 5143
  363.                Belmont, Ca. 94002
  364.  
  365.             (Please send check or money order, do not send cash.  People
  366.           who want to order MyComm from outside the U.S. should obtain a
  367.           money order in U.S. dollars from a local bank.)
  368.  
  369.             For your convenience there is a file called ORDER.FRM which is
  370.           an order form for MyComm.  The order form is also included in
  371.           Appendix F of this document.  Please note that if you downloaded
  372.           MyComm from a BBS that charges a subscription fee, obtained a
  373.           copy of MyComm from a "shareware disk copying" service, or CD ROM
  374.           library the registration fee for MyComm is not paid for or
  375.           collected by those services!
  376.  
  377.             MyComm represents many, many hours of work on my part in
  378.           research, design, coding, testing, revisions, enhancements and
  379.           writing the documentation.  Writing a piece of software like
  380.           MyComm is not trivial.  Your registration not only gives me the
  381.           incentive to continue producing and upgrading shareware products
  382.           like this one, but it is the right thing to do.
  383.  
  384.             Let's face it.  $25 is not a lot to spend on a program that
  385.           does everything MyComm does.  Comparable communications packages
  386.           are generally much more expensive.  The Shareware market is an
  387.           "all risk" venture for the author, while the user has everything
  388.           to gain.  Your registration tells me that MyComm was worth
  389.           creating, and that people like it.  I like to know that people
  390.           appreciate the effort I put into a project, don't we all?  Enjoy
  391.           using the MyComm software, and I'm looking forward to hearing
  392.           from you.
  393.  
  394.  
  395.           MyComm Version 2.23 Documentation                 Page 3
  396.  
  397.  
  398.  
  399.             When you register MyComm I will send you the most recent
  400.           version of MyComm and its documentation on floppy disk (standard
  401.           3.5" or 5.25" disk, 3.5" preferred).  At this time I am not
  402.           offering a printed manual in order to keep the cost of the
  403.           software reasonable.  Registered users will also be offered a
  404.           discount on future upgrades.  Please bear in mind that the
  405.           registered versions have the latest revisions and enhancements
  406.           (another registration incentive).
  407.  
  408.           Multiple registrations to the same individual or site will be
  409.           discounted as follows:
  410.  
  411.                1  to 5    copies      -  no discount
  412.                6  to 10   copies      -  5% discount
  413.                11 to 25   copies      - 10% discount
  414.                26 to 50   copies      - 20% discount
  415.                51 to 100  copies      - 30% discount
  416.                over 100 copies        - inquire for quote
  417.  
  418.             Inquiries for site licenses and multiple registrations of
  419.           MyComm should be directed to the above address, or via Compuserve
  420.           (Tm) 73113,3536.  In the case of site licenses and multiple
  421.           registrations a maximum of five (5) diskettes will be sent with
  422.           the order unless otherwise negotiated.
  423.  
  424.             Registered users will be granted license to use the MyComm
  425.           software as they deem fit and within the law.  The registered
  426.           version of MyComm may be duplicated for backup purposes only.
  427.           The registered version of MyComm may not used on more than one
  428.           computer at a time with the exception that registered users may
  429.           install MyComm on their computer at work and their computer at
  430.           home providing that the two computers are not operated
  431.           simultaneously.
  432.  
  433.             Businesses, corporations, organizations, government agencies,
  434.           or schools who intend to use MyComm on more than one computer at
  435.           a time must contact me for a site license.  The registration of
  436.           an individual copy of MyComm is not to be construed a site
  437.           license (let's be serious).  Feel free to contact me regarding
  438.           multiple registrations and site licenses.
  439.  
  440.             All users are granted a limited license to make copies of the
  441.           unregistered "shareware" version of MyComm for the purpose of
  442.           allowing others to try it out, and the unregistered version may
  443.           also be uploaded to public bulletin board systems subject to the
  444.           above restrictions as well as the following:
  445.  
  446.                ■    MyComm must be distributed in completely unmodified
  447.                     form, and include all support files and documentation.
  448.  
  449.  
  450.           MyComm Version 2.23 Documentation                 Page 4
  451.  
  452.  
  453.  
  454.                ■    MyComm may not be included or bundled with any other
  455.                     product for any reason without a license from the
  456.                     author, Ken Dorshimer.
  457.  
  458.                ■    No charge or payment may be levied or accepted for the
  459.                     MyComm software except by the author, Ken Dorshimer.
  460.  
  461.             MyComm may not be sold or distributed through a third party
  462.           (this includes copying services and shareware distribution
  463.           outlets which distribute software for a copying fee) without the
  464.           expressed written permission of the author, Ken Dorshimer.
  465.           Shareware distribution services and bulletin boards which charge
  466.           a fee for software distribution should contact me for written
  467.           permission to distribute MyComm.
  468.  
  469.  
  470.           MyComm Version 2.23 Documentation                 Page 5
  471.  
  472.  
  473.  
  474.             The MyComm executable file(s) and documentation, both the
  475.           "registered" and "unregistered" versions are copyrighted material
  476.           and may not be modified or reverse engineered in any manner.  If
  477.           you require modified or customized versions of MyComm for
  478.           whatever reason feel free to contact the author at the address
  479.           above.
  480.  
  481.           1.2  Disclaimer and Warranty
  482.  
  483.           Disclaimer and Warranty:
  484.  
  485.             MyComm was designed and coded on a best efforts basis in
  486.           accordance with the standard of care usually and reasonably
  487.           expected in the performance of such computer software.
  488.  
  489.             THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS".  THE
  490.           AUTHOR, KEN DORSHIMER, MAKES NO WARRANTY OF ANY KIND, EITHER
  491.           EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED
  492.           WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
  493.           OR THE SOFTWARE'S USEFULNESS IN A PARTICULAR APPLICATION.  IN NO
  494.           EVENT SHALL THE AUTHOR, KEN DORSHIMER, BE LIABLE FOR ANY DAMAGES
  495.           (INCLUDING DAMAGES FOR LOSS OF BUSINESS OR PERSONAL PROFITS,
  496.           BUSINESS OR PERSONAL INTERRUPTION, LOSS OF BUSINESS OR PERSONAL
  497.           INFORMATION, OR OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF
  498.           OR INABILITY TO USE THIS PROGRAM, EVEN IF THE AUTHOR, KEN
  499.           DORSHIMER, HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  500.           THE USER ASSUMES FULL RESPONSIBILITY AND LIABILITY FOR THE PROPER
  501.           USE OF THE MYCOMM SOFTWARE AND ACCOMPANYING DOCUMENTATION.
  502.  
  503.           <Whew>, glad the legal stuff is out of the way.  If I hadn't
  504.           included that my attorney would have had me drawn and quartered.
  505.  
  506.  
  507.           1.3  Definitions, Acronyms, Acknowledgements, and Abbreviations
  508.  
  509.                ■ BBS       -  Bulletin Board System
  510.  
  511.                ■ IBM       -  Trademark, International Business Machines
  512.  
  513.                ■ Hayes     -  Hayes (trademark) compatible modems have
  514.                               become the defacto standard in modem
  515.                               communications. The Hayes command set are
  516.                               modem commands preceded by "AT"
  517.  
  518.                ■ DOS       -  Disk Operating System
  519.  
  520.                ■ MS-DOS    -  Microsoft Disk Operating System, trademark of
  521.                               Microsoft Corporation.
  522.  
  523.  
  524.           MyComm Version 2.23 Documentation                 Page 6
  525.  
  526.  
  527.  
  528.                ■ Shareware  - A marketing system where users are allowed to
  529.                               evaluate software before purchase and
  530.                               registration.
  531.  
  532.                ■ XMODEM    -  A file transfer protocol developed by Ward
  533.                               Christensen in the summer of 1977.
  534.  
  535.                ■ YMODEM    -  A file transfer protocol based on XMODEM
  536.                               developed by Chuck Forsberg.
  537.  
  538.                ■ ZMODEM    -  A file transfer protocol developed by Chuck
  539.                               Forsberg/Omen Technology, Inc.
  540.  
  541.                ■ SEAlink   -  A file transfer protocol based on XMODEM
  542.                               developed by System Enhancement Associates,
  543.                               Inc. Copyright 1986, 1987 by System
  544.                               Enhancement Associates, Inc.
  545.  
  546.                ■ Kermit    -  A file transfer protocol developed by
  547.                               Columbia University, New York, NY.
  548.  
  549.                ■ WordStar  -  Trademark (company unknown) of an editor
  550.                               which has been around since the early days of
  551.                               personal computers.
  552.  
  553.                ■ Unix      -  Trademark of operating system designed by
  554.                               Bell Labs/Western Electric.
  555.  
  556.                ■ VT-nnn    -  As in VT-52, VT-100, etc. are trademarks of
  557.                               the Digital Equipment Corporation.
  558.  
  559.                ■ 3270      -  3270 and 7171 are designations used by IBM
  560.                               for terminal emulation and protocol
  561.                               conversion respectively.
  562.  
  563.             Any other names, trademarks, etc. not mentioned here belong to
  564.           whomever they belong to.  If there are errors or omissions, and
  565.           you let me know, I will make an effort to correct them in the
  566.           next version of this documentation.
  567.  
  568.  
  569.           1.4  General System Requirements
  570.  
  571.             MyComm is designed to run under the PC/MS-DOS operating system.
  572.           MyComm may be run either from a hard drive or a floppy drive,
  573.           although a floppy drive is not recommended when performing file
  574.           transfers (just too slow).  Great care has been taken to keep the
  575.           code size small so MyComm will run with as little as 200K of main
  576.           memory (RAM) available.  MyComm will run using a Monochrome
  577.           Graphics Adapter (MGA), a true Hercules (Tm) monochrome card,
  578.           EGA, and VGA.
  579.  
  580.  
  581.           MyComm Version 2.23 Documentation                 Page 7
  582.  
  583.  
  584.  
  585.  
  586.             MyComm is designed to use modems which use the Hayes (Tm) "AT"
  587.           command set.  Your modem should support this standard or a subset
  588.           of it.  MyComm supports modem speeds of 300, 1200, 2400, 4800,
  589.           9600, 19200, 38400, 57600, and 115200 baud and a wide variety of
  590.           data bit, parity bit, and stop bit settings.
  591.  
  592.  
  593.           1.5  MyComm Files
  594.  
  595.             The files included in the MyComm package are:
  596.  
  597.                ■ MYCOMM.EXE  -     MyComm main executable program.
  598.  
  599.                ■ MYCOMM.DOC  -     Documentation for MyComm (you're reading
  600.                                    it now).
  601.  
  602.                ■ ORDER.FRM   -     Order form for MyComm.
  603.  
  604.                ■ BUGRPT.FRM  -     Form to describe any problems or
  605.                                    bugs you may have found, or to make
  606.                                    suggestions for future versions of
  607.                                    MyComm.
  608.  
  609.                ■ SCP_CHK.EXE -     Program to check the syntax of script
  610.                                    file commands. See Appendix-E "MyComm
  611.                                    Script Language" for more information.
  612.  
  613.                ■ *.SCP       -     Example MyComm "script" language files.
  614.  
  615.             MyComm also creates and modifies the following files as part of
  616.           its normal operation:
  617.  
  618.                ■ MYCOMM.CFG   -    MyComm configuration file.
  619.  
  620.                ■ MYCOMM.PHN   -    MyComm phone list file.
  621.  
  622.                ■ MYCOMM.OLD   -    Backup of the MyComm phone list file.
  623.  
  624.                ■ MYCOMM.SCR   -    File created when you capture the screen
  625.                                    to a file (see Alt W).
  626.  
  627.                ■ MYCOMM.SES   -    File created when capturing your current
  628.                                    session to a file (see Alt S).
  629.  
  630.                ■ Other Files  -    phone lists that you create, script
  631.                                    files, and any files that were
  632.                                    downloaded.
  633.  
  634.  
  635.           MyComm Version 2.23 Documentation                 Page 8
  636.  
  637.  
  638.  
  639.           1.6  MyComm Support and Technical Assistance
  640.  
  641.             MyComm technical assistance is offered in the following ways:
  642.  
  643.           ■    Contact the author through Compuserve at 73113,3536
  644.                (preferred method)
  645.  
  646.           ■    Write to:
  647.                P.O. Box 5143
  648.                Belmont, Ca. 94002
  649.  
  650.  
  651.           2.0  MyComm Installation and Running
  652.  
  653.             MyComm is amazingly simple to install and use.  That's the
  654.           whole idea!  The instructions in this section will have you up
  655.           and running in no time.  Pay special attention to the information
  656.           that should be in your CONFIG.SYS file, and the stuff about the
  657.           COM ports.
  658.  
  659.  
  660.           2.1  System Requirements
  661.  
  662.             MyComm is designed to run on IBM or compatible personal
  663.           computers under the MS-DOS operating system.  Machines may be of
  664.           the PC, XT, AT, 386 or above class of personal computers.
  665.  
  666.             MyComm has the following system requirements:
  667.  
  668.                 ■   at least 200K of free memory (RAM).
  669.  
  670.                 ■   MS-DOS version 3.0 or greater or similar "after market"
  671.                     Disk Operating System.
  672.  
  673.                 ■   Hayes compatible modem which accepts the " AT " command
  674.                     set.
  675.  
  676.                 ■   Your CONFIG.SYS file should contain the statements:
  677.  
  678.                          Device=ANSI.SYS
  679.                          Files=40
  680.                          Buffers=40
  681.  
  682.                     If your CONFIG.SYS file does not contain these
  683.                     statements then you will need to modify the CONFIG.SYS
  684.                     file.  The CONFIG.SYS file may be edited with an
  685.                     ordinary text editor.  Simply type in a line that reads
  686.                     "Device=ANSI.SYS", "Files=40", and one that reads
  687.                     "Buffers=40" (without the quotes) and save the file.
  688.                     Refer to your DOS manual if you need more information
  689.                     on CONFIG.SYS.
  690.  
  691.  
  692.           MyComm Version 2.23 Documentation                 Page 9
  693.  
  694.  
  695.  
  696.  
  697.  
  698.           2.2  MyComm Installation Instructions
  699.  
  700.             Before you start the MyComm installation you should know which
  701.           COM port your modem is set for.  Consult your modem manual if
  702.           you're not sure.  Modems vary too much from one manufacturer to
  703.           another to describe every difference in this manual.
  704.  
  705.           Step 1:   Modify your CONFIG.SYS file to make any of the required
  706.                     changes described in section 2.1 above.
  707.  
  708.           Step 2:   Create a directory on your hard drive (or a floppy
  709.                     drive) called "MYCOMM" and change directory into the
  710.                     new "MYCOMM" directory.
  711.  
  712.                                Example:
  713.  
  714.                                    C:
  715.                                    CD\
  716.                                    MD MYCOMM
  717.                                    CD MYCOMM
  718.  
  719.           Step 3:   Copy the MYCOMM files into this new directory.
  720.  
  721.           Step 4:   Run MyComm.  At the DOS command prompt type "MYCOMM"
  722.                     then press the <Enter> key.
  723.  
  724.           Step 5:   MyComm will start to load.  The first time MyComm is
  725.                     run it will tell you that it can't find the
  726.                     "Configuration File".  It will then create a new
  727.                     configuration file called MYCOMM.CFG.  MyComm will also
  728.                     create an empty phone dialing list called MYCOMM.PHN.
  729.  
  730.           Step 6:   MyComm has a default COM port setting of COM Port 1.
  731.                     If your modem is set up for COM 1 already, don't sweat
  732.                     it.  Otherwise, MyComm will prompt you for the serial
  733.                     port to use.  Choose the COM Port that your modem is
  734.                     set on.  MyComm will then try to initialize the COM
  735.                     Port.  If all goes well you should see the letters "OK"
  736.                     on the screen under the copyright notice.  If the modem
  737.                     doesn't appear to be responding, try repeating Step 6
  738.                     using another COM Port (if you have more than one) or
  739.                     see Appendix D "Troubleshooting".
  740.                       You can see if the modem is responding correctly by
  741.                     typing "AT" (without the quotes) and then press
  742.                     <Enter>.  The modem should respond with "OK".  You may
  743.                     test the phone line connection by typing "ATM1DT"
  744.                     (again, without the quotes) then press <Enter>.  This
  745.                     command tells the modem to turn its' speaker on, then
  746.                     dial nothing.  You should hear a dial tone from the
  747.  
  748.  
  749.           MyComm Version 2.23 Documentation                 Page 10
  750.  
  751.  
  752.  
  753.                     modem speaker.  Press <Enter> again and the dial tone
  754.                     should stop and the modem should respond with "NO
  755.                     CARRIER".
  756.  
  757.            Step 7:  Press the <Alt> and "U" key.  This will bring up
  758.                     MyComm's Update Configuration Menu.  Go through each of
  759.                     the menu options and make any changes required.  The
  760.                     remainder of this documentation describes each of the
  761.                     MyComm options and functions.
  762.  
  763.            Step 8:  You will also need to modify the "Modem Initialization
  764.                     String".  This is done in the "Modem Setup" screen.
  765.                     MyComm needs to see text response codes from the modem
  766.                     rather than numeric codes.  The general purpose
  767.                     initialization string that MyComm uses as by default
  768.                     is:
  769.  
  770.                          AT M1 X4 Q0 V1 S0=0 S11=50 S7=50 &C1 &D2^M
  771.  
  772.                     Broken down this means:
  773.  
  774.                     AT     - "Hi modem! I'm sending you commands now".
  775.                     M1     - Turn on modem speaker (M0 turns it off).
  776.                     X4     - Select highest level of responses.
  777.                     Q0     - Always send responses.
  778.                     V1     - Send text responses.
  779.                     S0=0   - Do not answer the phone.
  780.                     S11=50 - Use fast dialing speed.
  781.                     S7=50  - Wait time for Carrier Detect in seconds.
  782.                     &C1    - Keep Carrier Detect (CD) low until a
  783.                              connection is made.
  784.                     &D2    - Use RTS/CTS flow control (important on
  785.                              high speed modems).
  786.                     ^M     - Send Carriage Return character (MyComm
  787.                              internal command - see also Appendix J).
  788.  
  789.  
  790.           MyComm Version 2.23 Documentation                 Page 11
  791.  
  792.  
  793.  
  794.           2.3  Running MyComm
  795.  
  796.             Section 3 of this document covers all the options and functions
  797.           that MyComm offers.  There are some additional items that should
  798.           be covered first.
  799.  
  800.             MyComm may be started in a number of ways.  Below are three
  801.           different methods to start the MyComm program.
  802.  
  803.           Method 1: Start MyComm from the directory that you installed
  804.                     MyComm in. For example:
  805.  
  806.                          CD\MYCOMM
  807.  
  808.                     then type "MYCOMM" and press the <Enter> key.  This
  809.                     will start the MyComm program.
  810.  
  811.           Method 2: MyComm will also load from any directory if you have
  812.                     set a "Path" with the DOS path command that points to
  813.                     the directory MyComm lives in.  For example to set the
  814.                     path type:
  815.  
  816.                          PATH=C:\MYCOMM
  817.  
  818.                     providing of course that you installed MyComm in the
  819.                     directory C:\MYCOMM.  Just substitute the appropriate
  820.                     path in that case.
  821.  
  822.           Method 3: You may also specify the "fully qualified" DOS path to
  823.                     start MyComm.  For example:
  824.  
  825.                         C:\MYCOMM\MYCOMM
  826.  
  827.                    will also cause MyComm to start.
  828.  
  829.             If you have questions about the DOS Path commands or statements
  830.           please refer to your DOS manual.
  831.  
  832.             If you are using DOS version 3.0 or higher MyComm will
  833.           automatically find it's configuration file.  This means that
  834.           MyComm may be started from any drive or directory on your system
  835.           without having to always start in the MyComm directory  This will
  836.           save you the trouble (and typing) of changing directories when
  837.           you want to use MyComm.
  838.  
  839.             MyComm will however try to start a new phone file in the
  840.           directory you are in unless you have included the fully qualified
  841.           path to the phone directory file in the Setup options.  This
  842.           allows you to keep multiple phone files in different directories
  843.           depending on your needs.
  844.  
  845.  
  846.           MyComm Version 2.23 Documentation                 Page 12
  847.  
  848.  
  849.  
  850.           2.4  Command Line Parameters
  851.  
  852.             MyComm will take several "command line" parameters.  Command
  853.           line parameters are commands that are typed after the program
  854.           name at the DOS prompt. For example typing
  855.  
  856.                MYCOMM -J MYSCRIPT.SCP
  857.  
  858.           on the command line will cause MyComm to start then to
  859.           immediately (after initial logo screen) "join" the script
  860.           MYCSCRIPT.SCP.  A description of the command line parameters that
  861.           MyComm understands follows.
  862.  
  863.           :2.4.1 Join Script
  864.  
  865.             The -J <script name> parameter causes MyComm to start the named
  866.           script immediately after MyComm starts up.  See the section "Join
  867.           Script" for more details on MyComm script functions.  Please note
  868.           that the "Join Script" function takes precedence over the "Dial"
  869.           command described below.
  870.  
  871.  
  872.           :2.4.2 Dial Entries  (Registered version only)
  873.  
  874.             The -D <n1, n2, ... nx> function tells MyComm to mark the
  875.           dialing entries that correspond to the numbers after the -D and
  876.           begin dialing them.  This would be the same as if you had gone
  877.           into the dialing directory and manually marked number for dialing
  878.           then started the Call command.  For example
  879.  
  880.                MYCOMM -D 2 4 14 15
  881.  
  882.           will mark dialing entries 2, 4, 14, and 15 and then begin to call
  883.           those entries after MyComm initializes.  Please note that entries
  884.           are separated by a space.  If the dialing entry is invalid it is
  885.           ignored.
  886.  
  887.  
  888.           MyComm Version 2.23 Documentation                 Page 13
  889.  
  890.  
  891.  
  892.           2.4.3 Timed Start  (Registered version only)
  893.  
  894.             The -T <HH:MM> function starts a timer that waits until the
  895.           specified time before MyComm begins to do anything else.  The
  896.           time may be entered as follows:
  897.  
  898.                 2:00          2:00 Am
  899.                14:00          2:00 Pm  (military time)
  900.                 2:00P         2:00 Pm
  901.  
  902.           For example
  903.  
  904.                MYCOMM -T 6:00P
  905.  
  906.           would tell MyComm that you want to wait until 6:00 Pm before it
  907.           does something.  This is especially useful for setting a timer
  908.           for the -J or -D commands (described above).  While MyComm is
  909.           waiting for the start time a message box is displayed.  You may
  910.           quit the timer by pressing the <ESC> key.
  911.  
  912.  
  913.           3.0  MyComm Screens and Menus
  914.  
  915.             MyComm has several screens and menus to allow you to change
  916.           various options and to perform various functions.  Most screens
  917.           and menus are brought up by pressing the <ALT> key and then a
  918.           letter.  Pressing <F1> while in the terminal screen shows you
  919.           Help Menu which lists all of the MyComm functions (see also
  920.           section 3.2).
  921.  
  922.  
  923.           MyComm Version 2.23 Documentation                 Page 14
  924.  
  925.  
  926.  
  927.           3.1  Terminal Screen
  928.  
  929.             When MyComm is first loaded, and after the configuration file
  930.           has been read, it defaults to the terminal screen which looks
  931.           like this:
  932.  
  933.  
  934.           MyComm <Version Information>
  935.           Copyright (c) 1992 - 1994 Ken Dorshimer  -  All rights reserved.
  936.  
  937.           Press <F1> for Help
  938.           Press <Alt-D> for Dial Screen
  939.  
  940.  
  941.             You will see the version number, and copyright notice.
  942.  
  943.             In the terminal screen you may enter regular Hayes - AT modem
  944.           commands, or choose one of the many MyComm functions.  The MyComm
  945.           functions are listed in the Help Menu which is displayed when you
  946.           press the <F1> key on your keyboard.  The MyComm functions are
  947.           described in more detail in the following sections of this
  948.           manual.
  949.  
  950.  
  951.           3.2  Help Menu - F1
  952.  
  953.             Pressing the <F1> key brings up the MyComm Help Screen which
  954.           looks like this:
  955.  
  956.           (NOTE: many of the MyComm screens shown in this documentation are
  957.           smaller than actual size so that they will fit on a printed
  958.           page.)
  959.  
  960.  
  961.           MyComm Version 2.23 Documentation                 Page 15
  962.  
  963.  
  964.  
  965.           +------------------------------------------------| MyComm Help |+
  966.           |                                                               |
  967.           |                     MyComm Commands                           |
  968.           |                                                               |
  969.           |Alt A  Activate Chat Mode         Alt J  Join Script           |
  970.           |Alt B  Send Break                 Alt M  Manual Dial           |
  971.           |Alt C  Clear the Screen           Alt O  Outside to DOS        |
  972.           |Alt D  Dialing Functions          Alt P  Change Port Parameters|
  973.           |Alt E  Toggle Local Echo On/Off   Alt Q  Quick Re-Dial         |
  974.           |Alt F  Toggle Line Feeds On/Off   Alt R  Run External Program  |
  975.           |Alt H  Hang up modem              Alt S  Session Capture On/Off|
  976.           |Alt I  Send Modem Init. String    Alt T  Terminal Emulation    |
  977.           |Alt K  Scroll BacK                Alt U  Update Configuration  |
  978.           |Alt L  Current Line Status        Alt W  Write Screen to File  |
  979.           |                                                               |
  980.           |                                                               |
  981.           |F1     Help With Commands         Alt X  EXit MyComm           |
  982.           |F2     Send Name                  PgDn   Download Files        |
  983.           |F3     Send Password              PgUp   Upload Files          |
  984.           |F4     Send Tagline                                            |
  985.           |                                                               |
  986.           |                                                               |
  987.           |  MyComm <Version Information>                                 |
  988.           | Copyright (c) 1992 - 1994 Ken Dorshimer - All rights reserved.|
  989.           |                                                               |
  990.           +---------------------------------------------------------------+
  991.  
  992.             Pressing <Esc> or any other key closes the MyComm Help Screen
  993.           window.
  994.  
  995.  
  996.           3.3  Chat Mode - Alt A
  997.  
  998.             Pressing the <ALT> and the "A" key brings you into the MyComm
  999.           Chat window.  The chat screen is useful when you want to send
  1000.           text messages or "chat" interactively with someone while on-line.
  1001.           If you were not using the Chat Mode the "conversation" would
  1002.           eventually end up looking like a garbled mess on your screen.
  1003.  
  1004.             The Chat window is divided horizontally.  The top half of the
  1005.           screen is where received characters are written, the bottom half
  1006.           is where the characters you type are written.
  1007.  
  1008.             To exit Chat Mode, press the <Esc> key.
  1009.  
  1010.           Please note: Some BBS "chat" systems send special control
  1011.           characters to emulate a split screen chat or colors.  Since there
  1012.           is no filtering done by MyComm while in Chat Mode this may cause
  1013.           strange effects in your receive window.  If this occurs, exit
  1014.           from Chat Mode and allow the BBS software to control the chat
  1015.           session.
  1016.  
  1017.  
  1018.           MyComm Version 2.23 Documentation                 Page 16
  1019.  
  1020.  
  1021.  
  1022.  
  1023.           3.4  Send Break - Alt B
  1024.  
  1025.             Pressing the <ALT> and the "B" key sends a special modem signal
  1026.           called "BREAK".  Some host systems use the Break signal to
  1027.           perform special functions such as ending a session.
  1028.  
  1029.  
  1030.           3.5  Clear the Screen - Alt C
  1031.  
  1032.             Pressing the <ALT> and the "C" key clears the screen and resets
  1033.           the current color attributes.  Many host systems send color
  1034.           information which stays in place even after you log off. Clear
  1035.           Screen resets the screen colors to the ones you chose.
  1036.  
  1037.  
  1038.           3.6  Dialing Functions - Alt D
  1039.  
  1040.             Pressing the <ALT> and the "D" keys displays the MyComm Dial
  1041.           Screen.  From this screen you may add, delete, edit, view, find,
  1042.           and mark phone list entries, and of course dial phone list
  1043.           entries.  You will see the options available from this screen
  1044.           written into the little window at the bottom of the screen. The
  1045.           letter which activates an option will appear highlighted or in a
  1046.           different color.  A description of the dialing functions follows.
  1047.  
  1048.             You will see a bar highlighting the current phone list item.
  1049.           The highlight bar may be moved up and down by using the Up-Arrow,
  1050.           Down-Arrow, Page Up, Page Down, Home and End keys.  The highlight
  1051.           bar appears as reverse video bar on monochrome screens.
  1052.  
  1053.           +------------------------------------------------| Dial Screen |+
  1054.           |                                                               |
  1055.           |   #   Name                     Phone Number         Last Call |
  1056.           |                                                               |
  1057.           |   1   Your Favorite BBS       555-4657               01/26/92 |
  1058.           |   2   The Music Board         555-8944               01/19/92 |
  1059.           |   .           .                  .                      .     |
  1060.           |   .           .                  .                      .     |
  1061.           |   .           .                  .                      .     |
  1062.           |  15                                                  00/00/00 |
  1063.           |---------------------------------------------------------------|
  1064.           |                                                               |
  1065.           | Add  Edit  Delete  Call  Info  Manual  (Un)MarK  Find  Load   |
  1066.           |                    Sort  moVe  Print                          |
  1067.           +---------------------------------------------------------------+
  1068.  
  1069.  
  1070.           MyComm Version 2.23 Documentation                 Page 17
  1071.  
  1072.  
  1073.  
  1074.           3.6.1  Add Phone List Item
  1075.  
  1076.             Pressing the "A" key in the Dial Screen window adds a blank
  1077.           entry after the currently highlighted entry.
  1078.  
  1079.  
  1080.           3.6.2  Edit Phone List Item Screen
  1081.  
  1082.             Pressing the "E" key in the Dial Screen window brings up the
  1083.           Dial Edit window.  This is where you set up the phone list entry
  1084.           for each system you will call.  There are several options to
  1085.           choose from, and each is described.  You may also use the Up-
  1086.           Arrow and Down-Arrow keys to move between items.  Items such as
  1087.           Name, Number, etc use MyComm's Line Editor described in Appendix
  1088.           B.
  1089.  
  1090.           +----------------------------------------| Edit |+
  1091.           |                                                |
  1092.           | Name:                 Your Favorite BBS        |
  1093.           | Number:               555-4657                 |
  1094.           | Baud Rate: 2400       Data Bits: 8             |
  1095.           | Data Parity: None     Stop Bits: 1             |
  1096.           | Default Protocol:     1K-Xmodem                |
  1097.           | Dial Prefix: 1        ATDT*70                  |
  1098.           | Logon Name:           Your Name                |
  1099.           | Password:             Password                 |
  1100.           | Terminal Type: ANSI                            |
  1101.           | Local Echo: No                                 |
  1102.           | Received BS Destructive: Yes                   |
  1103.           | BS Key Sends BS or DELete: BS                  |
  1104.           | Strip Hi Bits? (Pure ASCII): No                |
  1105.           | Add LF after incoming CR?: No                  |
  1106.           | Script                                         |
  1107.           | Clear last date called and number of calls?    |
  1108.           |                                                |
  1109.           +------------------------------------------------+
  1110.  
  1111.           The following describes each phone list item and how to configure
  1112.           it.
  1113.  
  1114.           3.6.2.1  Name
  1115.  
  1116.             Just type in the name of the bulletin board system or person
  1117.           you will call here.
  1118.  
  1119.  
  1120.           MyComm Version 2.23 Documentation                 Page 18
  1121.  
  1122.  
  1123.  
  1124.           3.6.2.2  Number
  1125.  
  1126.             The telephone number of the system you will call goes in here.
  1127.           The telephone number may include spaces or hyphens for
  1128.           readability (modems usually ignore spaces and hyphens).
  1129.           Characters such as letters or other gibberish will probably
  1130.           confuse your modem.  MyComm will assume that whatever you put
  1131.           here is a valid telephone number.
  1132.  
  1133.  
  1134.           3.6.2.3  Baud Rate
  1135.  
  1136.             Choose a baud rate (300, 1200, 2400, 4800, 9600, 19200, 38400,
  1137.           57600, or 115200) that you want MyComm to use when connected to
  1138.           the system.  For a more accurate reading of the data rate during
  1139.           file transfers (described elsewhere in this manual) and the on-
  1140.           line status (also described elsewhere in this manual) the baud
  1141.           rate should be set to the rate of the system that you will be
  1142.           calling.
  1143.  
  1144.  
  1145.           3.6.2.4  Data Bits
  1146.  
  1147.             Choose the data bits (5, 6, 7, 8) that you want MyComm to use
  1148.           when connected to the system.  8 data bits is the most common
  1149.           setting for public bulletin board systems.  7 data bits are
  1150.           common on mainframes and many Unix (Tm) systems.  5 and 6 data
  1151.           bits are rarely used by many systems any longer, but are included
  1152.           for completeness.
  1153.  
  1154.             Most host systems in their advertisements, etc. tell you what
  1155.           Data, Parity, and Stop bits they expect.  You will often see them
  1156.           listed as 8-N-1 or similar.  8-N-1 means 8 data bits, no parity
  1157.           (None), and 1 stop bit. 8-N-1 is the most common setting used.
  1158.           If in doubt, try 8-N-1 first.
  1159.  
  1160.  
  1161.           3.6.2.5  Data Parity
  1162.  
  1163.             Choose the data parity (None, Even, Odd, Mark, Space) that you
  1164.           want MyComm to use when connected to the system.  None is usually
  1165.           used on most systems, especially with 8 data bits.  Even parity
  1166.           is common when using 7 data bits.
  1167.  
  1168.  
  1169.           3.6.2.6  Stop Bits
  1170.  
  1171.             Choose the stop bits (1, 2) that you want MyComm to use when
  1172.           connected to the system.  1 stop bit is the most common.
  1173.  
  1174.  
  1175.           MyComm Version 2.23 Documentation                 Page 19
  1176.  
  1177.  
  1178.  
  1179.           3.6.2.7  Default Protocol
  1180.  
  1181.             MyComm allows you to choose the file transfer protocol that you
  1182.           will use by default for each system you call.  Choose the
  1183.           protocol which best suits your needs.  A more complete
  1184.           description of the various protocols is found later in this
  1185.           manual in the section on Uploading and DownLoading Files.
  1186.  
  1187.  
  1188.           3.6.2.8  Dial Prefix
  1189.  
  1190.             Choose the dialing prefix that you want MyComm to use when
  1191.           calling the number for this system.  MyComm has slots for three
  1192.           different dialing prefixes.  Choose one by moving the highlight
  1193.           bar to the selection you want.  The dialing prefixes may be
  1194.           changed to suit your needs in the Update Configuration menu
  1195.           option.
  1196.  
  1197.  
  1198.           3.6.2.9  Logon Name
  1199.  
  1200.             This option lets you enter the name that you log on with when
  1201.           you call this system.  When bulletin board systems answer your
  1202.           call they usually ask for your name and password.
  1203.  
  1204.             Putting the characters "^M" at the end of the Logon Name causes
  1205.           an <Enter> character to be sent.  Some BBS's don't like seeing an
  1206.           <Enter> character immediately after the Logon Name string when
  1207.           logging on, in which case you should leave the "^M" out.
  1208.  
  1209.             If Logon Name is filled in MyComm will send your logon name
  1210.           when you push the <F2> key to save you some typing.
  1211.  
  1212.  
  1213.           3.6.2.10 Password
  1214.             This option lets you enter the password that you log on with
  1215.           when you call this system.  When bulletin board systems answer
  1216.           your call they usually ask for your name and password.
  1217.  
  1218.             If Password is filled in MyComm will send your logon password
  1219.           when you push the <F3> key to save you some typing.  If you are
  1220.           really security conscious, then you may leave this option blank.
  1221.  
  1222.             Putting the characters "^M" at the end of the Password causes
  1223.           an <Enter> character to be sent.  Some BBS's don't like seeing an
  1224.           <Enter> character immediately after the Password string when
  1225.           logging on, in which case you may leave the "^M" out.
  1226.  
  1227.  
  1228.           MyComm Version 2.23 Documentation                 Page 20
  1229.  
  1230.  
  1231.  
  1232.           3.6.2.11 Terminal Type
  1233.             This option lets you choose the type of terminal emulation to
  1234.           use when calling this system.  The choices are TTY, ANSI, VT-52,
  1235.           VT-100 and 3270 (registered version only).
  1236.  
  1237.             TTY (TeleTYpe) gives no emulation what-so-ever. The characters
  1238.           appear on your screen just as they come in with no formatting.
  1239.  
  1240.             ANSI emulation provides functions similar to your ANSI.SYS
  1241.           driver to provide color attributes (except on mono monitors of
  1242.           course), blinking characters and other goodies.  MyComm uses
  1243.           intelligent ANSI character translation which filters out any ANSI
  1244.           sequences which cause "keyboard re-mapping".  This prevents the
  1245.           unscrupulous from sending ANSI sequences to your personal
  1246.           computer system that could potentially cause damage or annoyance.
  1247.  
  1248.             VT-52 and VT-100, and 3270 are most commonly used on mainframe
  1249.           hosts.  Some bulletin boards also support these.  Both of these
  1250.           emulations support a subset of the DEC protocols including a
  1251.           mapping to the "keypad mode" used to generate commands on DEC
  1252.           terminals.  It should be noted that VT-52 is an "ANSI
  1253.           incompatible" emulation, and VT-100 is ANSI compatible.
  1254.  
  1255.             A listing of the keys supported for the ANSI, VT-52, VT-100,
  1256.           and 3270 emulations is in Appendix C - Terminal Emulations.
  1257.  
  1258.           3.6.2.12 Local Echo
  1259.  
  1260.             Local Echo is used when the other system does not send the
  1261.           characters typed on your terminal back to you.  Most systems do
  1262.           echo characters back, so Local Echo is normally off ("No").  If
  1263.           you find that you can't see what you are typing when connected to
  1264.           a system, set Local Echo on ("Yes").  On the other hand if you
  1265.           see double characters when you hit a key (for example you see
  1266.           "xx" when you type an "x") then Local Echo should be off ("No").
  1267.  
  1268.  
  1269.           3.6.2.13 Received BS (BackSpace) Destructive
  1270.  
  1271.             This option tells MyComm whether received BackSpace or DELete
  1272.           characters should back up the cursor and erase what was there.
  1273.           Usually this On.
  1274.  
  1275.  
  1276.           3.6.2.14 BS Key Sends BS or DELete
  1277.  
  1278.             This option tells MyComm whether to send a BS (BackSpace - 8
  1279.           decimal) or DEL (Delete - 127 decimal) character when the
  1280.           backspace key is pressed.  Usually this is set to BS.  Mainframe
  1281.           hosts usually like to see DEL rather than BS.
  1282.  
  1283.  
  1284.           MyComm Version 2.23 Documentation                 Page 21
  1285.  
  1286.  
  1287.  
  1288.  
  1289.           3.6.2.15 Strip Hi Bits
  1290.  
  1291.             This option tells MyComm whether to strip the high bit from
  1292.           received and sent characters. Usually this is set to "No".
  1293.  
  1294.             Just for your own information, bytes on the personal computer
  1295.           are 8 bits long.  So, the bit-map of a byte might be 10011101.
  1296.           The left-most bit is the high bit.  So if you were to strip the
  1297.           high bit, the byte above would become 00011101.  Pure ASCII only
  1298.           covers bytes in the range of 00000000 (0 decimal) to 01111111
  1299.           (127 decimal).  The ANSI extended set includes values from
  1300.           10000000 (128 decimal) to 11111111 (255 decimal).  So by
  1301.           stripping the high bit, a character is guaranteed to be in the
  1302.           range of the pure ASCII character set.
  1303.  
  1304.  
  1305.           3.6.2.16 Add LF after incoming CR
  1306.  
  1307.             This option tells MyComm whether to add a LF (Line Feed - 10
  1308.           decimal) character after a CR (Carriage Return - 13 decimal)
  1309.           character is received.  Usually this is set to "No".
  1310.  
  1311.             If you notice that the lines on the screen seem to look odd or
  1312.           do not scroll up properly, you will want to turn this on (Yes).
  1313.  
  1314.  
  1315.           3.6.2.17 Clear last date called and number of calls
  1316.  
  1317.             Each time you connect with a system MyComm updates the last
  1318.           date and time called portion the dialing entry record.  If you
  1319.           want to reset the date and time the system was last called and
  1320.           the number of times you have called it, answer "Yes" here.
  1321.  
  1322.           3.6.2.18 Script
  1323.  
  1324.             This is where you will put the name of the script file that you
  1325.           want to run ("Join") when you connect with this system.  For a
  1326.           complete discussion of the MyComm script language see Appendix -
  1327.           E "MyComm Script Language".
  1328.  
  1329.  
  1330.           3.6.2.19 Save Changes (not shown in example)
  1331.  
  1332.             MyComm asks if you want to save the changes you just made.  If
  1333.           you answer "Yes" MyComm updates the phone file on your disk
  1334.           drive.  When MyComm updates the phone file a backup of the phone
  1335.           file is created and named PHONE.OLD.
  1336.  
  1337.  
  1338.           MyComm Version 2.23 Documentation                 Page 22
  1339.  
  1340.  
  1341.  
  1342.           3.6.3  Delete an Item
  1343.  
  1344.             Pressing the "T" key allows you to delete the item that is
  1345.           currently at the dialing highlight bar.  MyComm asks you to
  1346.           confirm the delete request before proceeding.  MyComm also
  1347.           updates the phone file on your disk drive.
  1348.  
  1349.  
  1350.           3.6.4  Call Numbers (Dial)
  1351.  
  1352.             Pressing the "C" key tells MyComm that it's time to start
  1353.           calling numbers in the Dialing List  (See also section 3.6.7
  1354.           (Un)MarK).  Pressing the <Enter> key also will start the dialing.
  1355.  
  1356.             If no Dialing List Items are "marked" MyComm will dial the
  1357.           number that the highlight bar is currently resting on.  If there
  1358.           are "marked" Dialing List Items, MyComm will start dialing the
  1359.           marked numbers in sequence until a connection is made.  During
  1360.           the dialing attempts you may cancel the dialing by pressing the
  1361.           <Esc> key.
  1362.  
  1363.             While MyComm is calling numbers and waiting for a connection, a
  1364.           Dial Status Window is displayed (see example below).  The status
  1365.           window shows who is being called and the telephone number, how
  1366.           many call tries have been made so far, the status of the last
  1367.           dialing try, the time in seconds until this try "times out", the
  1368.           time since you started calling, and the time that the current
  1369.           dialing attempt started.
  1370.  
  1371.           +-------------------------------------------------------| Dial |+
  1372.           |                                                               |
  1373.           |  Calling: Your Favorite BBS        At: 555-4657               |
  1374.           |                                                               |
  1375.           |  Try # 1       Last Status: None Yet        Dial Time:  42    |
  1376.           |                                                               |
  1377.           |  Dialing started at:  3:01:20   This try started at:  3:01:21 |
  1378.           |                                                               |
  1379.           |                                                               |
  1380.           |          Hit ESC to quit dialing, 'N' for next number,        |
  1381.           |          or 'D' to delete number from list.                   |
  1382.           |                                                               |
  1383.           +---------------------------------------------------------------+
  1384.  
  1385.             Pressing the "N" key causes MyComm to stop dialing  the number
  1386.           it is currently dialing and to skip to the next marked number.
  1387.  
  1388.             Pressing the "D" key causes MyComm to stop dialing the number
  1389.           it is currently calling and to remove it from the list of
  1390.           "marked" numbers.  If you press "D" and the number is the only
  1391.           one left in the "marked" list, MyComm will give you a warning and
  1392.           stop dialing.
  1393.  
  1394.  
  1395.           MyComm Version 2.23 Documentation                 Page 23
  1396.  
  1397.  
  1398.  
  1399.  
  1400.             The Dial Time and Pause Time between calls is a user
  1401.           configuration option which may be set up in the Update
  1402.           Configuration menu described later in this document.
  1403.  
  1404.           3.6.5  Phone Item Info Screen
  1405.  
  1406.             The Phone Item Info Screen looks very much like the Edit Phone
  1407.           List Item Screen with the exception that the Last Call Date, Last
  1408.           Call Time, and Number of Calls fields are shown.  If you see
  1409.           something you want to change, pressing "E" will bring you to the
  1410.           Edit Phone List Item Screen.
  1411.  
  1412.           +------------------------------| Phone Item Info |+
  1413.           |                                                 |
  1414.           | Name:                 Your Favorite BBS         |
  1415.           | Number:               555-4657                  |
  1416.           | Baud Rate: 2400       Data Bits: 8              |
  1417.           | Data Parity: None     Stop Bits: 1              |
  1418.           | Default Protocol:     1K-Xmodem                 |
  1419.           | Dial Prefix: 1        ATDT*70                   |
  1420.           | Logon Name:           Your Name                 |
  1421.           | Password:             Password                  |
  1422.           | Terminal Type: ANSI                             |
  1423.           | Local Echo: No                                  |
  1424.           | Received BS Destructive: Yes                    |
  1425.           | BS Key Sends BS or DELete: BS                   |
  1426.           | Strip Hi Bits? (Pure ASCII): No                 |
  1427.           | Add LF after incoming CR?: No                   |
  1428.           |                                                 |
  1429.           | Last Call Date:       01/26/92                  |
  1430.           | Last Call Time:        4:26:12                  |
  1431.           | Number of Calls:            28                  |
  1432.           |                                                 |
  1433.           |          Press "E" to Edit Record               |
  1434.           +-------------------------------------------------+
  1435.  
  1436.  
  1437.           3.6.6  Manual Dial Screen
  1438.  
  1439.             Pressing "M" brings up the Manual Dial Screen.  The Manual Dial
  1440.           Screen lets you enter a single phone number to dial.  The dialing
  1441.           prefix used is always Dialing Prefix number 1.
  1442.           Pressing <Esc> cancels the function.  Pressing <Enter> accepts
  1443.           the telephone number and the usual Dialing Status Window appears.
  1444.  
  1445.           +-------------------------------------| Manual Dial |+
  1446.           |                                                    |
  1447.           |  Enter phone number: 555-1234                      |
  1448.           |                                                    |
  1449.           +----------------------------------------------------+
  1450.  
  1451.  
  1452.           MyComm Version 2.23 Documentation                 Page 24
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.           3.6.7  Mark Phone List Items
  1459.  
  1460.             Pressing "K" marks or un-marks phone list items for later
  1461.           dialing.  As a convenience, pressing the <Space> bar also marks
  1462.           and un-marks items.  When a phone list item is marked a chevron
  1463.           ("»") will appear next to the item.
  1464.  
  1465.  
  1466.           3.6.8  Find Phone List Items
  1467.  
  1468.             Pressing "F" brings up the Find Phone List Items screen (not
  1469.           shown).  Simply type in the characters in the name, or a partial
  1470.           phone number that you want to find.  The search is started at the
  1471.           top of the list.  If the search fails, a message is displayed.
  1472.  
  1473.  
  1474.           3.6.9  Load Phone List Screen
  1475.  
  1476.             Pressing "L" brings up the Load Phone List Screen.  You may
  1477.           keep more than one phone dialing list.  Each list will hold up to
  1478.           100 telephone numbers.  If the dialing list you select does not
  1479.           yet exist, MyComm will display an empty dialing list.
  1480.             Again, when changes are made to the phone file, MyComm will
  1481.           create or update the file PHONE.OLD as a backup.  There is only
  1482.           one PHONE.OLD backup file kept, so all new backups overwrite the
  1483.           last PHONE.OLD backup file.
  1484.  
  1485.  
  1486.           3.6.10 Sort Phone List
  1487.  
  1488.             You may sort the Phone List in one of four ways:
  1489.  
  1490.             - by BBS name
  1491.             - by Telephone number
  1492.             - by last date called
  1493.             - by number of times called
  1494.  
  1495.             The sort option will also ask you for Ascending or Descending
  1496.           sort order.  Simply select the sort option that best suits your
  1497.           needs.  The list will be saved in the new sort order.  Pressing
  1498.           <Esc> exits the Sort menu.
  1499.  
  1500.  
  1501.           MyComm Version 2.23 Documentation                 Page 25
  1502.  
  1503.  
  1504.  
  1505.           3.6.11 Move Phone List Item
  1506.  
  1507.             This option allows you to move a phone list item to another
  1508.           location in the list.  This will save you some retyping if you
  1509.           want to customize your phone list.
  1510.  
  1511.             To use this option move the highlight bar to the phone list
  1512.           item that you want to move.  Press the "V" key.  Next use the up
  1513.           and down arrow keys to move the highlight bar to the position
  1514.           that you would like the item moved to.  Press the <Enter> key to
  1515.           make the move permanent, or <Esc> to quit the move.
  1516.  
  1517.  
  1518.           3.6.12 Print Phone List
  1519.  
  1520.             This option allows you to print the phone list.  The phone list
  1521.           may also be "printed" to a text file.  The printed output shows
  1522.           the BBS name, phone number, and last date called.
  1523.  
  1524.             To use this option press "P".  You will then be asked for a
  1525.           file name to "print" to.  To print to your printer (PRN) simply
  1526.           press <Enter> (PRN is a standard DOS device name for the
  1527.           printer).  A status message is displayed while the phone list is
  1528.           being printed.  The printing may be stopped by pressing the <Esc>
  1529.           key.
  1530.  
  1531.  
  1532.           3.7  Local Echo On/Off - Alt E
  1533.  
  1534.             Local Echo is used when the other system does not send the
  1535.           characters you typed on your terminal back to you.  Most systems
  1536.           do echo characters back, so Local Echo is normally off ("No").
  1537.           If you find that you can't see what you are typing when connected
  1538.           to a system, set Local Echo on (Yes).  On the other hand if you
  1539.           see double characters when you hit a key (for example you see
  1540.           "xx" when you type an "x") then Local Echo should be off ("No").
  1541.  
  1542.  
  1543.           3.8  Line Feeds On/Off - Alt F
  1544.  
  1545.             This function toggles the "Line Feeds" on or off.  When "on"
  1546.           Line Feed characters are appended to the display in the terminal
  1547.           window each time a Carriage Return character is received.  When
  1548.           "off" no Line Feed character is added.
  1549.  
  1550.             This is useful when the host system is not sending Line Feed
  1551.           characters to you and the display does not drop down to a new
  1552.           line when each new line of text is received.
  1553.  
  1554.  
  1555.           MyComm Version 2.23 Documentation                 Page 26
  1556.  
  1557.  
  1558.  
  1559.           3.9  Hang Up Modem - Alt H
  1560.  
  1561.               Pressing the <ALT> and the "H" key tells MyComm that you want
  1562.           to disconnect from your current telephone connection.  MyComm
  1563.           will try to hang up the phone first by dropping the modem signal
  1564.           called DTR, and if that fails by sending the Hang Up String
  1565.           defined in the Modem Setup Screen (see section 3.17.1  Modem
  1566.           Setup Screen).  If you don't want MyComm to use DTR to hang up
  1567.           the modem set the option "Use DTR to Hang Up Modem" in Modem
  1568.           Setup Screen to "No".
  1569.  
  1570.  
  1571.           3.10  Send Modem Initialization Strings - Alt I
  1572.  
  1573.             Pressing the <ALT> and the "I" key brings up the Send Init.
  1574.           String Menu shown below.  Choosing one of these options will send
  1575.           the Modem Initialization String, or the Hang Up String (same as
  1576.           <Alt> + H), or the Modem Attention String, or the Phone Answer
  1577.           String.  These strings are defined in the Modem Setup Screen (see
  1578.           section 3.17.1  Modem Setup Screen).
  1579.  
  1580.                +-------| Send... |+
  1581.                | Init. String     |
  1582.                | Hang Up String   |
  1583.                | Attention String |
  1584.                | Phone Answer     |
  1585.                +------------------+
  1586.  
  1587.  
  1588.           3.11 Join Script - Alt J
  1589.  
  1590.             This option will allow you to "Join" in or run a script file.
  1591.           You will be asked to supply the name of the script file which
  1592.           MyComm will then load.  If the script file can not be opened you
  1593.           will see an error message.  You may quit the script by pressing
  1594.           the <Esc> key until you see the "Yes/No" window that asks if you
  1595.           want to quit the script.  See Appendix-E "Script Language" for
  1596.           more information on script files.
  1597.  
  1598.  
  1599.           3.12 Present Line Status - Alt L
  1600.  
  1601.             Pressing the <ALT> and the "L" key brings up the Present Line
  1602.           Status Window.  This window tells you the current COM Port
  1603.           Status, i.e. what Port, Baud Rate, Data Bits, Parity Bits, and
  1604.           Stop Bits are in effect, whether you are on-line and for how
  1605.           long.  If you are on-line MyComm tells you the name of the system
  1606.           you are logged onto, and the default file transfer protocol.
  1607.           Also shown is the present Local Echo status and whether Session
  1608.           Capture is active.  Pressing <Esc> closes the window.
  1609.  
  1610.  
  1611.           MyComm Version 2.23 Documentation                 Page 27
  1612.  
  1613.  
  1614.  
  1615.           +--------------------------| Present Line Status |+
  1616.           |                                                 |
  1617.           |  COM Port Status COM2, 2400, 8, N, 1           |
  1618.           |    ----------------------------------------     |
  1619.           |                                                 |
  1620.           | On-line: Yes          Time On-line:  0:00:00    |
  1621.           | Logged on to:         My Favorite BBS           |
  1622.           | Current Protocol:     None                      |
  1623.           |    ----------------------------------------     |
  1624.           |                                                 |
  1625.           | Local Echo On:      No                          |
  1626.           | Screen Capture On:  Yes                         |
  1627.           |    ----------------------------------------     |
  1628.           |                                                 |
  1629.           | Current Time: 12:34:56          Date: 01/23/93  |
  1630.           +-------------------------------------------------+
  1631.  
  1632.  
  1633.           3.13 Scroll Back - Alt K
  1634.  
  1635.             Pressing the <ALT> and the "K" key brings up the "scroll back"
  1636.           buffer.  MyComm saves the last few screens of received text for
  1637.           you.  This option allows you to see what has been recently
  1638.           received in case there was something that went by too quickly
  1639.           that you would like to look at again.  The scroll back buffer
  1640.           saves about two to three screens worth of information depending
  1641.           on how much actual text was in the previous screens (about 4K's
  1642.           worth).  The scroll back buffer does not display ANSI or high bit
  1643.           characters, they are stripped out to leave more room for useful
  1644.           information.
  1645.  
  1646.             When the scroll back buffer is first shown it displays the very
  1647.           beginning of the buffer information.  The up-arrow, down-arrow,
  1648.           Page Up, and Page Down keys scroll the text.  You may also write
  1649.           the buffer to a file by pressing the "W" key.  To exit press the
  1650.           <Esc> key.
  1651.  
  1652.  
  1653.           3.14 Manual Dial - Alt M
  1654.  
  1655.             Pressing the <ALT> and the "M" key brings up the Manual Dial
  1656.           Screen.  The Manual Dial Screen lets you enter in a single phone
  1657.           number to dial.  The dialing prefix used is always Dialing Prefix
  1658.           number 1.  The parity setting is always 8-N-1.
  1659.           If you press <Esc> you may cancel the selection.  Pressing
  1660.           <Enter> accepts the telephone number and the usual Dialing Status
  1661.           Window appears.  This is exactly the same function as in the
  1662.           Dialing Screen, selection "M", described above.
  1663.  
  1664.  
  1665.           MyComm Version 2.23 Documentation                 Page 28
  1666.  
  1667.  
  1668.  
  1669.           3.15 Outside to DOS - Alt O
  1670.  
  1671.             Pressing the <ALT> and the "O" key lets you shell out of MyComm
  1672.           to DOS.  You may use the Outside to DOS even when you are on-
  1673.           line.  Typing "EXIT" on the DOS command line brings you back to
  1674.           MyComm.
  1675.  
  1676.             One point of interest here: if you switch to a different drive
  1677.           or directory while in the DOS shell, MyComm will automagically
  1678.           bring you back to the drive and directory you started from when
  1679.           you type "EXIT" to return to MyComm.
  1680.  
  1681.  
  1682.           3.16 Change Port Parameters - Alt P
  1683.  
  1684.             Pressing the <ALT> and the "P" key brings up the Change Port
  1685.           Parameters Screen (see example below).  MyComm will let you
  1686.           change the port configuration, even while on-line.  Please note
  1687.           however that changing the COM Port while on-line will probably
  1688.           disconnect the current session.  However Data, Parity, and Stop
  1689.           Bits may be changed.
  1690.  
  1691.             Please note that the changes done here are not permanent.  To
  1692.           make permanent changes to the COM port settings, you must use the
  1693.           "Update Configuration" which is brought up by pressing <Alt> and
  1694.           "U" then the "M" key.
  1695.  
  1696.           +-----------------------| Change Port Parameters |+
  1697.           |                                                 |
  1698.           | Present settings: COM2, 2400, 8, N, 1           |
  1699.           |                                                 |
  1700.           | COM Port:2                                      |
  1701.           |                                                 |
  1702.           |           +---------+                           |
  1703.           |           | 1: COM1 |                           |
  1704.           +-----------| 2: COM2 |---------------------------+
  1705.                       | 3: COM3 |
  1706.                       | 4: COM4 |
  1707.                       | 5: COM5 |
  1708.                       | 6: COM6 |
  1709.                       | 7: COM7 |
  1710.                       | 8: COM8 |
  1711.                       +---------+
  1712.  
  1713.  
  1714.           MyComm Version 2.23 Documentation                 Page 29
  1715.  
  1716.  
  1717.  
  1718.           3.17 Quick Re-Dial - Alt Q
  1719.  
  1720.             Pressing the <ALT> and the "Q" key allows you to redial the
  1721.           last number that MyComm dialed.  This is especially useful for
  1722.           re-dialing manually entered telephone numbers.
  1723.  
  1724.  
  1725.           3.18 Run External Program - Alt R
  1726.  
  1727.             Pressing the <ALT> and the "R" key brings up the Run External
  1728.           Program Screen (not shown).  MyComm lets you define an editor
  1729.           program plus up to three other programs that you may run without
  1730.           leaving your MyComm session.  The external programs are defined
  1731.           in Paths Setup (see 3.19.2  Paths Setup).
  1732.             If there is not enough available memory to run the external
  1733.           program, the external program will not run and control passes
  1734.           directly back to MyComm.
  1735.  
  1736.  
  1737.           3.19 Session Capture On/Off/Pause - Alt S
  1738.  
  1739.             Pressing the <ALT> and the "S" key opens the MyComm Session
  1740.           Capture Screen (not shown).  You may either accept the default
  1741.           name that MyComm provides for the capture file or enter a new
  1742.           name.  If the Drive:\Path\Filename is in any way invalid, MyComm
  1743.           will issue an error message.  You may also press <Esc> to leave
  1744.           the Session Capture Screen without starting the Session Capture.
  1745.  
  1746.             After a Session Capture has begun pressing the <ALT> and the
  1747.           "S" key again will allow you to Close, or Pause/Resume the
  1748.           capture file.
  1749.  
  1750.             If you exit MyComm and forget to Close the Session Capture
  1751.           file, MyComm will do it for you.
  1752.  
  1753.             Please note that often while Session Capture is active, that
  1754.           the display may appear jerky, or start and stop from time to
  1755.           time.  This is normal during Session Capture as it is the time
  1756.           that MyComm is writing the file to disk.
  1757.  
  1758.  
  1759.             It may also be important to know that the Session Capture does
  1760.           not do any ANSI filtering.  What you see is what you get.
  1761.           Generally you will read the Session Capture file using a text
  1762.           editor or word processor when you are no longer "on line".  Text
  1763.           editors and word processors often perform ANSI filtering for you.
  1764.  
  1765.  
  1766.           MyComm Version 2.23 Documentation                 Page 30
  1767.  
  1768.  
  1769.  
  1770.           3.20 Terminal Emulation - Alt T
  1771.  
  1772.             MyComm allows you to reset the Terminal Emulation even while
  1773.           on-line.  The options are: TTY, ANSI, VT-52, VT-100, and 3270.
  1774.           Further information on the emulation may be found in Appendix C -
  1775.           "Terminal Emulations".
  1776.  
  1777.            Update Configuration - Alt U
  1778.  
  1779.             Pressing the <ALT> and the "U" key brings up the Update
  1780.           Configuration Menu (see below).  From this menu you may choose
  1781.           various options to allow you to customize the MyComm
  1782.           configuration.  You may either use the Up and Down-Arrow keys,
  1783.           then press <Enter> to choose an option, or simply press the
  1784.           highlighted letter of the option you want.  A description of the
  1785.           options that may be configured follows.
  1786.  
  1787.                      +---| Update Configuration |+
  1788.                      | Modem Setup               |
  1789.                      | Paths and Filenames       |
  1790.                      | File Transfer Options     |
  1791.                      | Other Stuff for MyComm    |
  1792.                      | COM Port Addresses        |
  1793.                      | Save Configuration        |
  1794.                      | Exit                      |
  1795.                      +---------------------------+
  1796.  
  1797.  
  1798.           .1  Modem Setup Screen
  1799.  
  1800.             The Modem Setup Screen (see below) allows you to make changes
  1801.           to the various setting that control the modem.  You may move from
  1802.           item to item by using the Up and Down-Arrow keys and then
  1803.           pressing <Enter>.  Some of the items use MyComm's built in line
  1804.           editor to modify the item, others use little pop-up Yes/No
  1805.           windows.  If you want to exit without making any changes, just
  1806.           press the <Esc> key.  A description of each item in the Modem
  1807.           Setup Screen follows.
  1808.  
  1809.  
  1810.           MyComm Version 2.23 Documentation                 Page 31
  1811.  
  1812.  
  1813.  
  1814.           +------------------------------------------------| Modem Setup |+
  1815.           |                                                               |
  1816.           | COM Port:                        COM2, 2400, 8, N, 1          |
  1817.           | Modem Initialization String:     ATM0X4Q0V1S0=0S11=50S7=50^M  |
  1818.           | Modem Attention String:          +++                          |
  1819.           | Modem Hang Up String:            ATH0^M                       |
  1820.           | Modem Answer String:             ATA^M                        |
  1821.           | Modem Cancel Dial String:        ^M                           |
  1822.           | Modem Dial Suffix String:        ^M                           |
  1823.           | Dialing Wait Time, in Seconds:    45                          |
  1824.           | Pause Between Calls, in Seconds:   4                          |
  1825.           | Local Echo on by Default?        No                           |
  1826.           | Use DTR to Hang Up Modem?        Yes                          |
  1827.           | Use XON/XOFF Flow Control?       Yes                          |
  1828.           | Use CTS/RTS Flow Control?        No                           |
  1829.           | Use DSR/DTR Flow Control?        No                           |
  1830.           | Dialing Prefix #1:               ATDT*70                      |
  1831.           | Dialing Prefix #2:               ATDT 9,                      |
  1832.           | Dialing Prefix #3:               ATDT 1                       |
  1833.           |                                                               |
  1834.           |                                                               |
  1835.           |          Use Up and Down Arrows to move between items         |
  1836.           |               Hit <Enter> to edit, <Esc> to Quit              |
  1837.           |                                                               |
  1838.           +---------------------------------------------------------------+
  1839.  
  1840.  
  1841.           .1.1  COM Port
  1842.  
  1843.             The COM Port selection allows you to set various COM port
  1844.           settings.
  1845.             When you first installed your modem you probably set the COM
  1846.           port up for COM1, COM2, etc. use the setting correct for your
  1847.           modem.  If you set the wrong COM port in this area, MyComm
  1848.           doesn't mind, but won't let you dial numbers later on.
  1849.  
  1850.             MyComm does not re-initialize the COM port when you make
  1851.           changes in this menu.  The new COM port settings will be used the
  1852.           next time that you run MyComm.  If you need to change the COM
  1853.           port settings now, use the Alt-P function from the main terminal
  1854.           screen.
  1855.  
  1856.             The baud rate should be set to whatever the top speed of your
  1857.           modem is.  Refer to your modem user manual if you're not sure.
  1858.  
  1859.             The most common settings for the Data, Parity, and Stop bits
  1860.           are 8-N-1 (8 data bits, no parity, 1 stop bit).  If you require
  1861.           different settings, this is the place to change them.
  1862.  
  1863.  
  1864.           MyComm Version 2.23 Documentation                 Page 32
  1865.  
  1866.  
  1867.  
  1868.           .1.2  Modem Initialization String
  1869.  
  1870.             This option lets you set up the Modem Initialization String.
  1871.           This is the string which is sent to the modem to "wake it up" and
  1872.           set options when MyComm is first loaded.  The initialization
  1873.           string is made up of Hayes "AT" commands.  The command line
  1874.           always starts with the letters "AT".  The rest of the line
  1875.           contains various options for your modem.  Your modem manual
  1876.           should have a list of the commands that are valid for your modem.
  1877.  
  1878.             MyComm always likes to have AT LEAST the Q0, V1, and X4
  1879.           commands.  Q0 tells the modem to ALWAYS send result codes, V1
  1880.           tells the modem to ALWAYS send the text, not numeric, result
  1881.           codes.  MyComm needs the result codes in text format to monitor
  1882.           call progress, and to send you other useful information that the
  1883.           modem produces.  X4 (your modem may use X1, X2, etc) tells the
  1884.           modem to send "verbose" modem status information to MyComm.
  1885.             You should place "^M" at the end of the Initialization String
  1886.           so that MyComm will send a Carriage Return at the end of the
  1887.           line.
  1888.  
  1889.           High speed modem users: If you need to set "flow control" options
  1890.           for your modem in the setup string this is the place to do it.
  1891.           For example, if your modem needs to use RTS/CTS flow control the
  1892.           Hayes AT command "&K3" should be added to the initialization
  1893.           string.
  1894.  
  1895.  
  1896.           .1.3  Modem Attention String
  1897.  
  1898.             This is the Attention signal that tells the modem that you want
  1899.           it's undivided attention for something.  Most Hayes compatible
  1900.           modems use three plus signs "+++" as the attention string.  Refer
  1901.           to your modem manual if you use a different Attention string.
  1902.  
  1903.  
  1904.           .1.4  Modem Hang Up String
  1905.  
  1906.             This is the string that tells your modem to hang up the
  1907.           telephone line.  On most Hayes compatible modems this is ATH0.
  1908.           You may use the characters "^M" to have MyComm send a Carriage
  1909.           Return after it sends the Hang Up string (recommended).  Refer to
  1910.           your modem manual if you use a different Hang Up string.
  1911.  
  1912.  
  1913.           MyComm Version 2.23 Documentation                 Page 33
  1914.  
  1915.  
  1916.  
  1917.           .1.5  Modem Answer String
  1918.  
  1919.             This is the string that tells your modem to answer the
  1920.           telephone.  On most Hayes compatible modems this is ATA.  You may
  1921.           use the characters "^M" to have MyComm send a Carriage Return
  1922.           after it sends the Answer string (recommended).  Refer to your
  1923.           modem manual if you use a different Answer string.
  1924.  
  1925.  
  1926.           .1.6  Modem Cancel Dial String
  1927.  
  1928.             This is the string that tells your modem to cancel dialing a
  1929.           telephone number.  On most Hayes compatible modems this just a
  1930.           Carriage Return (13 decimal).  You may use the characters "^M" to
  1931.           send a Carriage Return after it sends the Cancel Dial string
  1932.           (recommended).  Refer to your modem manual if you use a different
  1933.           Cancel dialing string.
  1934.  
  1935.  
  1936.           .1.7  Modem Dial Suffix String
  1937.  
  1938.             This is the string that tells your modem what to terminate
  1939.           telephone numbers with when dialing.  On most Hayes compatible
  1940.           modems this just a Carriage Return.  You may use the characters
  1941.           "^M" to have MyComm send a Carriage Return as the Dial Suffix
  1942.           string (recommended).  Refer to your modem manual if you use a
  1943.           different Dial Suffix string.
  1944.  
  1945.  
  1946.           .1.8  Dialing Wait Time
  1947.  
  1948.             After MyComm dials a number it waits for this amount of time
  1949.           for a connection.  Waiting stops automatically if MyComm detects
  1950.           a BUSY signal.  The valid range for Dialing Wait Time is 1 to 240
  1951.           seconds.
  1952.  
  1953.             In general a wait time of 45 seconds is good for most local and
  1954.           long-distance calls, 60 seconds for international calls.
  1955.  
  1956.             You will also want to add "S7=nn" (without the quotes), to your
  1957.           modem Initialization String (see above). Replace "nn" with a
  1958.           number greater than or equal to the time set in Dialing Wait
  1959.           Time.
  1960.  
  1961.  
  1962.           MyComm Version 2.23 Documentation                 Page 34
  1963.  
  1964.  
  1965.  
  1966.           .1.9  Pause Between Calls
  1967.  
  1968.             If a connection is not made after dialing due to a BUSY signal
  1969.           or a time-out, MyComm resets the modem and waits the amount of
  1970.           seconds specified in the Pause Between Calls before trying to
  1971.           dial again.  The valid range for Pause Between Calls is 0 to 60
  1972.           seconds.
  1973.  
  1974.             In most cases a pause time of 2 to 5 seconds is sufficient for
  1975.           the modem to reset.
  1976.  
  1977.  
  1978.           .1.10 Local Echo on by Default
  1979.  
  1980.             Local Echo is used when the other system does not send what you
  1981.           typed on your terminal back to you.  Most systems do echo
  1982.           characters back, so Local Echo is normally off ("No").  If you
  1983.           find that you can't see what you are typing when connected to a
  1984.           system, set Local Echo on (Yes).  On the other hand if you see
  1985.           double characters when you hit a key (for example you see "xx"
  1986.           when you type an "x") then Local Echo should be off ("No").
  1987.  
  1988.  
  1989.           .1.11 Use DTR to Hang Up Modem
  1990.  
  1991.             This option allows you to set whether MyComm should use the
  1992.           modem signal called DTR to terminate connections.  Using DTR to
  1993.           hang up is usually faster than just sending the Hang Up String
  1994.           (above).  This option is usually set to "Yes".
  1995.  
  1996.             However, some modems don't like to have DTR messed with. You
  1997.           can usually tell if the modem doesn't like you to fool with DTR
  1998.           as it will cause your computer system to lock up (not a bad thing
  1999.           really, just terribly annoying - re-booting always fixes this).
  2000.           Refer to your modem manual if you have questions about whether to
  2001.           use DTR to hang up the telephone connection.
  2002.  
  2003.             NOTE: some modems require that you add "&D2" to your
  2004.           initialization string (see above) to enable the DTR line
  2005.           monitoring.  Check your modem manual for further details.
  2006.  
  2007.           .1.12 Use XON/XOFF Flow Control
  2008.  
  2009.             This tells MyComm whether it should use the XON/XOFF flow
  2010.           control while in terminal mode and during ASCII file transfers.
  2011.           This default for this option is "Yes".
  2012.  
  2013.  
  2014.           MyComm Version 2.23 Documentation                 Page 35
  2015.  
  2016.  
  2017.  
  2018.           .1.13 Use CTS/RTS Flow Control
  2019.  
  2020.             This tells MyComm whether to use CTS/RTS flow control.
  2021.           This is used with high speed modems and null modem cable links to
  2022.           regulate the flow of data. If the modem supports CTS/RTS flow
  2023.           control this should be on (refer to the user manual for your
  2024.           modem).  If a null modem cable is being used and these signals
  2025.           are to be sent over the cable, this should be on.
  2026.             You may also want to add "&K3" to your initialization string
  2027.           (see above) to enable your modem to follow CTS/RTS status.  This
  2028.           option is most often used on high speed modems.
  2029.  
  2030.  
  2031.           .1.14 Use DSR/DTR Flow Control
  2032.  
  2033.             This tells MyComm whether to use DSR/DTR flow control.
  2034.  
  2035.            Hardware handshaking is used with high speed modems and
  2036.           sometimes null modem cable links to regulate the flow of data.
  2037.           If the modem supports DSR/DTR flow control this should be "Yes"
  2038.           (refer to the user manual for your modem).  If a null modem cable
  2039.           is being used and these signals are to be sent over the cable,
  2040.           this should be on.
  2041.  
  2042.             You may also want to add "&D2" to your initialization string
  2043.           (see above) to enable your modem to follow DTR status.  This
  2044.           option is most often used on high speed modems.
  2045.  
  2046.  
  2047.           .1.15 Dialing Prefixes
  2048.  
  2049.             Dialing Prefixes are dialing codes such as area codes, that get
  2050.           sent before a telephone number is dialed.  You may set up three
  2051.           different dialing prefixes.  Each dialing prefix may be up to 25
  2052.           character/digits long.
  2053.  
  2054.             For example, if you have Call Waiting (Tm) you can disable it
  2055.           by dialing *70 (that's asterisk - 70) before the number you're
  2056.           calling (this works in the my dialing area, your dialing area may
  2057.           differ).  If you were to set one of your dialing prefixes to *70
  2058.           MyComm would "prefix" every number you called with *70.  The
  2059.           dialing prefixes may also be used to store long distance codes,
  2060.           or whatever dialing codes you would want to have dialed before a
  2061.           number.
  2062.  
  2063.  
  2064.           MyComm Version 2.23 Documentation                 Page 36
  2065.  
  2066.  
  2067.  
  2068.           .1.16 Connect Strings
  2069.  
  2070.             MyComm will use the strings defined in Connect and No Connect
  2071.           strings to determine the dialing status.  From this option you
  2072.           will be able to change the strings that MyComm will use as
  2073.           responses from your modem.
  2074.  
  2075.             There is one "Connect" string and four "No Connect" strings.
  2076.  
  2077.             The Connect string should be the same as the one your modem
  2078.           generates when a connection has been made.  The default is
  2079.           "CONNECT" which is fairly standard.  Please note: you must define
  2080.           this string so that MyComm will know when a connection has been
  2081.           made.  MyComm does not rely on the Carrier Detect signal to
  2082.           determine when it has connected during dialing!
  2083.  
  2084.             The "No Connect" strings should be set to whatever strings your
  2085.           modem generates when a connection is not made during dialing.
  2086.           When MyComm sees one of these responses from the modem during
  2087.           dialing it stops waiting for a connection and moves on to the
  2088.           next number to be dialed.  The default strings are "BUSY", "NO
  2089.           CARRIER", "NO DIALTONE", and "VOICE".
  2090.  
  2091.  
  2092.           .2  Paths Setup
  2093.  
  2094.             The Paths Setup Screen (see below) is where you set up paths to
  2095.           directories that you want MyComm to know about.  A description of
  2096.           the various system paths follows.
  2097.  
  2098.  
  2099.           +---------------------------------------------| Paths Setup |+
  2100.           |                                                            |
  2101.           | Directory to Download files to:  C:\PUBLIC\                |
  2102.           | Directory to Upload files from:  C:\PUBLIC\                |
  2103.           | Path\File for Screen Capture:    C:\PUBLIC\MYCOMM.SCR      |
  2104.           | Path\File for Session Capture:   C:\PUBLIC\MYCOMM.SES      |
  2105.           | Path\File for Phone File:        C:\MYCOMM\MYCOMM.PHN      |
  2106.           | Path\Filename.Ext for Editor:    C:\UTIL\EDITOR.EXE        |
  2107.           | Path\Filename.Ext of Xter Prog1: C:\SOMEPRGM.EXE           |
  2108.           | Path\Filename.Ext of Xter Prog2: C:\                       |
  2109.           | Path\Filename.Ext of Xter Prog3: C:\                       |
  2110.           |                                                            |
  2111.           |                                                            |
  2112.           |      Use Up and Down Arrows to move between items          |
  2113.           |           Hit <Enter> to edit, <Esc> to Quit               |
  2114.           |                                                            |
  2115.           +------------------------------------------------------------+
  2116.  
  2117.  
  2118.           MyComm Version 2.23 Documentation                 Page 37
  2119.  
  2120.  
  2121.  
  2122.           .2.1  Download Directory
  2123.  
  2124.             This option tells MyComm which directory you want MyComm to put
  2125.           files that are downloaded from another system.  Notice that the
  2126.           path always ends in a backslash ( "\" ) character.
  2127.  
  2128.  
  2129.           .2.2  Upload Directory
  2130.  
  2131.             This option tells MyComm which directory you want MyComm to get
  2132.           the files from that will be uploaded to other systems.  Notice
  2133.           that the path always ends in a backslash ( "\" ) character.
  2134.  
  2135.  
  2136.           .2.3  Path\File for Screen Capture
  2137.  
  2138.             This option tells MyComm which directory and the filename that
  2139.           you want MyComm to use for the Screen Capture file.  Screen
  2140.           Capture is activated by <Alt> + W.
  2141.  
  2142.  
  2143.           .2.4  Session Capture Path\File
  2144.  
  2145.             This option tells MyComm which directory and the filename that
  2146.           you want MyComm to use for the Session Capture file.  Session
  2147.           Capture is activated by <Alt> + S.
  2148.  
  2149.  
  2150.           .2.5  Phone File Path\File
  2151.  
  2152.             This option tells MyComm which directory and the filename that
  2153.           you want MyComm to use for the Phone File which contains your
  2154.           dialing directory.  You may have multiple Phone Files, but this
  2155.           is the one that MyComm will load when it starts up.
  2156.  
  2157.  
  2158.           .2.6  Editor Path\Filename
  2159.  
  2160.             If you want to use an editor program without leaving MyComm,
  2161.           this option lets you tell MyComm the path and filename of the
  2162.           editor.  Notice that the filename of the editor must include not
  2163.           only the filename, but the extension (.EXE or .COM) as well.
  2164.  
  2165.  
  2166.           MyComm Version 2.23 Documentation                 Page 38
  2167.  
  2168.  
  2169.  
  2170.           .2.7  External Programs Path\Filename
  2171.  
  2172.             You may define up to three other external programs to run
  2173.           without leaving your MyComm session.  Use these options to tell
  2174.           MyComm the paths and filenames of the programs.  Notice that the
  2175.           filename of the programs must include not only the filename, but
  2176.           the extension (.EXE, .COM, or .BAT) as well.
  2177.  
  2178.  
  2179.           .3  Protocols Setup
  2180.  
  2181.             The Protocols Setup Menu (see example below) allows changes to
  2182.           parameters for ASCII file transfers, Kermit file transfers,
  2183.           Zmodem file transfers, and the external protocols.
  2184.           The usage of these options follows.
  2185.  
  2186.                +--| Protocol Setup |+
  2187.                | ASCII Transfers    |
  2188.                | Zmodem Transfers   |
  2189.                | Kermit Transfers   |
  2190.                | EXternal Protocols |
  2191.                | Exit               |
  2192.                +--------------------+
  2193.  
  2194.  
  2195.           .3.1  ASCII Transfers Setup
  2196.  
  2197.             The ASCII Transfers Setup screen (see example below) lets you
  2198.           set up the parameters for ASCII file transfers.  ASCII file
  2199.           transfers are only used to transfer text files.  Program files
  2200.           and archived files, also known as binary files, should not be
  2201.           transferred as ASCII files.  Most of the options for the ASCII
  2202.           transfers work well with their default settings.  A description
  2203.           of the different options follows.
  2204.  
  2205.  
  2206.           MyComm Version 2.23 Documentation                 Page 39
  2207.  
  2208.  
  2209.  
  2210.  
  2211.           +----------------------------| ASCII Transfers Setup |+
  2212.           |                                                     |
  2213.           | Strip High Bits?:                 No                |
  2214.           | Remote Abort Char (0 for none):    0 (ASCII Value)  |
  2215.           |                                                     |
  2216.           | ASCII Upload Options                                |
  2217.           | CR Translation:                 None                |
  2218.           | LF Translation:                 None                |
  2219.           | Local Echo On During Uploads?:   Yes                |
  2220.           | Expand Blank Lines to Spaces?:    No                |
  2221.           | Line Pace time in 1/10 seconds:    0                |
  2222.           | Char Pace time in 1/10 seconds:    0                |
  2223.           | Pacing Char (0 for none):          0 (ASCII Value)  |
  2224.           |                                                     |
  2225.           | ASCII Download Options                              |
  2226.           | CR Translation:                 None                |
  2227.           | LF Translation:                 None                |
  2228.           |                                                     |
  2229.           |    Use Up and Down Arrows to move between items     |
  2230.           |          Hit <Enter> to edit, <Esc> to Quit         |
  2231.           +-----------------------------------------------------+
  2232.  
  2233.  
  2234.           .3.1.1  Strip High Bits
  2235.             This option tells MyComm whether to strip the high bit from
  2236.           received and sent characters during ASCII uploads and downloads.
  2237.           Usually this is set to "No".  See also section 3.6.2.15 "Strip
  2238.           High Bits" for a discussion of "high bits".
  2239.  
  2240.  
  2241.           .3.1.2  Remote Abort Char
  2242.  
  2243.             If the system you're performing the ASCII file transfer with
  2244.           uses an abort char to cancel transfers you should set this value.
  2245.           The value is in the range of 1 to 255.  A value of zero (0), the
  2246.           default, means MyComm won't look for the abort character during
  2247.           ASCII file transfers.
  2248.  
  2249.  
  2250.           3.21.3.1.3  CR Translation Upload and Download
  2251.  
  2252.             Some systems require a CR (Carriage Return) character placed
  2253.           before the LF (Line Feed) character during ASCII file transfers.
  2254.           If the lines of the file look odd after the transfer, this may be
  2255.           the case.
  2256.  
  2257.  
  2258.           MyComm Version 2.23 Documentation                 Page 40
  2259.  
  2260.  
  2261.  
  2262.           3.21.3.1.4  LF Translation Upload and Download
  2263.  
  2264.             Some systems require a LF (Line Feed) character placed after
  2265.           the CR (Carriage Return)  character during ASCII file transfers.
  2266.           If the lines of the file look odd after the transfer, this may be
  2267.           the case.
  2268.  
  2269.  
  2270.           .3.1.5  Local Echo On During Uploads
  2271.  
  2272.             During ASCII uploads if you want to watch the file transfer set
  2273.           this option to "Yes".  This is often used when uploading a
  2274.           message into a bulletin boards message base.  When this option is
  2275.           set to "No", the usual file transfer window is shown as the
  2276.           upload progresses.  Please note that when this option is set to
  2277.           "No" a Ctrl-Z (end of file marker) character is sent at the end
  2278.           of the file transfer.  When set to "Yes" the Ctrl-Z is not sent.
  2279.  
  2280.  
  2281.           .3.1.6  Expand Blank Lines to Spaces
  2282.  
  2283.             This option tells MyComm to expand lines that are empty except
  2284.           for a CR/LF into a line of spaces that end with a CR/LF.  This is
  2285.           useful when you are uploading a message to a bulletin board.
  2286.           Some boards interpret a blank line with only a CR/LF as the end
  2287.           of message signal.  Expanding blank lines allows you to upload
  2288.           the entire message.
  2289.  
  2290.  
  2291.           .3.1.7  Line Pace Time
  2292.  
  2293.             This options tells MyComm to how much time to wait between
  2294.           sending each line of text from the ASCII file.  Some systems
  2295.           can't handle high speed ASCII transfers, this gives the other
  2296.           system time to "think".  The value entered from 0 (the default)
  2297.           to 255 are in increments of 1/10 second (approximately).
  2298.  
  2299.  
  2300.           .3.1.8  Character Pace Time
  2301.  
  2302.             This options tells MyComm how much time to wait before sending
  2303.           each character from the ASCII file.  Some systems can't handle
  2304.           high speed ASCII transfers, this gives the other system time to
  2305.           "think".  The value entered from 0 (the default) to 255 is in
  2306.           increments of 1/10 second (approximately).
  2307.  
  2308.  
  2309.           MyComm Version 2.23 Documentation                 Page 41
  2310.  
  2311.  
  2312.  
  2313.           .3.1.9  Pacing Char
  2314.  
  2315.             Some systems send a Pacing Character to limit throughput on
  2316.           ASCII transfers.  MyComm will wait for the Pacing Char before
  2317.           sending each line of the file.  The Pacing Char value ranges from
  2318.           1 to 255 which represents an ASCII value.  A value of zero (0),
  2319.           the default, means MyComm will not look for the Pacing Char.
  2320.  
  2321.  
  2322.           .3.2  Zmodem Transfers Setup
  2323.  
  2324.             MyComm lets you define certain special functions used in the
  2325.           Zmodem file transfer protocol.  A description of these follows.
  2326.  
  2327.  
  2328.           .3.2.1  Zmodem 32 Bit CRC
  2329.  
  2330.             Zmodem uses either a 16 bit or a 32 bit CRC for error detection
  2331.           during file transfers.  The 32 bit CRC provides a much higher
  2332.           degree of accuracy than its 16 bit cousin.  However the
  2333.           calculation involved in the 32 bit CRC may slow the file transfer
  2334.           rate (by only a few CPS though).  If you want a high degree of
  2335.           error detection this option should be set to "Yes".  For higher
  2336.           transfer speed, set this option to "No".
  2337.  
  2338.  
  2339.           .3.2.2  Zmodem Auto Download Feature
  2340.  
  2341.             When this option is set to "Yes" MyComm will automatically
  2342.           start a Zmodem download file transfer for you.  The Zmodem
  2343.           protocol at the host's end sends some special characters when it
  2344.           starts up a Zmodem transfer.  MyComm looks for these characters
  2345.           and will save you some typing by starting up the Zmodem download
  2346.           for you.  If you don't want to use this feature, set this option
  2347.           to "No".
  2348.  
  2349.  
  2350.           .3.2.3  Zmodem Send Crash Recovery
  2351.  
  2352.             Sometimes a file transfer will fail after a file has been
  2353.           partially sent.   A file transfer could fail due to excessive
  2354.           line noise for example.  Zmodem has a rather nifty feature that
  2355.           will attempt to restart a failed file transfer.
  2356.  
  2357.             For normal use this feature should be set to "No".  If you want
  2358.           to attempt to restart a failed Zmodem transfer set this option to
  2359.           "Yes" before beginning the upload again.  If the system you are
  2360.           trying to upload the file to supports the "Crash Recovery"
  2361.           feature the file transfer will resume where it left off.
  2362.  
  2363.  
  2364.           MyComm Version 2.23 Documentation                 Page 42
  2365.  
  2366.  
  2367.  
  2368.           .3.2.4  Zmodem Receive Crash Recovery
  2369.  
  2370.             Sometimes a file transfer will fail after a file has been
  2371.           partially received.  Zmodem has a rather nifty feature that will
  2372.           attempt to restart a failed file transfer.
  2373.  
  2374.             For Normal use this feature should be set to "No".  If you want
  2375.           to attempt to restart a failed Zmodem transfer then set this
  2376.           option to "Yes" before beginning the download again.  If the
  2377.           system you are trying to download the file from supports the
  2378.           "Crash Recovery" feature the file transfer will resume where it
  2379.           left off.
  2380.  
  2381.             THIS OPTION SHOULD BE USED WITH CARE.  If this option is set to
  2382.           "Yes" and you download a file from another system that has the
  2383.           same name as a file you already have in your download directory,
  2384.           the end of the existing file will be overwritten with the
  2385.           information from the new file.  This option should only be set to
  2386.           "Yes" when you are attempting to restart a previously failed
  2387.           Zmodem transfer.
  2388.  
  2389.             NOTE: the Zmodem Crash Recovery option has some rudimentary
  2390.           idiot proofing.  The option will not perform the transfer if the
  2391.           file you have has a different time/date stamp than the other
  2392.           system, or if the file that you have is larger than the file on
  2393.           the other system.
  2394.  
  2395.  
  2396.           3.21.3.3  Kermit Transfers Setup
  2397.  
  2398.             Kermit was designed to allow many different types of machines
  2399.           to send data to each other.  In order to do this Kermit places a
  2400.           special "escape" character before any control characters
  2401.           encountered.  However this compatibility does have its price,
  2402.           Kermit is one of the slowest protocols in use today.  There are
  2403.           several parameters that may be adjusted. Most people will never
  2404.           need to change any of these, but for those who may a brief
  2405.           description follows.
  2406.  
  2407.  
  2408.           MyComm Version 2.23 Documentation                 Page 43
  2409.  
  2410.  
  2411.  
  2412.  
  2413.           File Format:             Binary or ASCII. Generally 8 bit or 8th
  2414.                                    bit stripped (sometimes called "Text"
  2415.                                    mode) respectively
  2416.  
  2417.           Packet Size:             Allowable range is 10 to 94
  2418.  
  2419.           Number of Pad Chars:     0 - none, if needed valid range 1 to 94
  2420.  
  2421.           Pad Char:                0 - ignored, if needed valid range 1 to
  2422.                                    94
  2423.  
  2424.           Quote Char:              35 ASCII, 23 hex, # symbol by default
  2425.  
  2426.           Packet Start Char:       01 ASCII, SOH by default
  2427.  
  2428.           EOLN Char:               13 ASCII, 0D hex, carriage return by
  2429.                                    default
  2430.  
  2431.  
  2432.           3.21.3.4  External Protocols Setup
  2433.  
  2434.             Up to six external file transfer protocols may be defined.
  2435.           Once defined the external file transfer protocols will appear in
  2436.           the Upload and Download protocol selection menus.
  2437.             Use the Up and Down-Arrow keys to move from item to item.  The
  2438.           <Enter> key selects an item for editing and saves the completed
  2439.           edit.  Pressing the <Esc> key quits the edit.
  2440.  
  2441.  
  2442.           +-----------------------------------| External Protocols Setup |+
  2443.           |                                                               |
  2444.           | Protocol  Name    Upload.Bat    Download.Bat     Ask FileName |
  2445.           |                                                               |
  2446.           |   1:   BIGFAST    BIGFASTU.BAT  BIGFASTD.BAT     No           |
  2447.           |   2:                                             Yes          |
  2448.           |   3:                                             Yes          |
  2449.           |   4:                                             Yes          |
  2450.           |   5:                                             Yes          |
  2451.           |   6:                                             Yes          |
  2452.           |                                                               |
  2453.           |         Use Up and Down Arrows to move between items          |
  2454.           |               Hit <Enter> to edit, <Esc> to Quit              |
  2455.           +---------------------------------------------------------------+
  2456.  
  2457.             The name of the external protocol should be typed in under the
  2458.           "Name" heading as you would like it to appear in the MyComm
  2459.           Upload and Download protocol selection menus.
  2460.  
  2461.             In the fields for Upload.Bat and Download.Bat you will enter
  2462.           the names of the DOS batch files that will be used to run the
  2463.  
  2464.  
  2465.           MyComm Version 2.23 Documentation                 Page 44
  2466.  
  2467.  
  2468.  
  2469.           external protocol.  External file transfer protocols are run as
  2470.           DOS batch files from MyComm (see your DOS manual for information
  2471.           on batch files).
  2472.  
  2473.             In the selection marked "Ask FileName" tells MyComm whether you
  2474.           should be asked the name of the file when performing downloads
  2475.           (some file transfer protocols automatically get the filename for
  2476.           you).
  2477.  
  2478.             MyComm sends the COM Port number you are using, the Baud Rate,
  2479.           and the Drive:\Path\ and filename as parameters for the batch
  2480.           file.  Using the example above, let's say you are using an
  2481.           external protocol called "BigFast", your COM Port is 2, the Baud
  2482.           Rate is 2400, and your upload directory is "C:\PUBLIC\" and you
  2483.           are uploading a file called MYSTUFF.ARC. The batch file for
  2484.           Uploads with BigFast would look something like this:
  2485.  
  2486.               REM BigFast Upload batch file
  2487.               BigFast Send Port: %1  Baud: %2 %3
  2488.  
  2489.           the %1 would be replaced by a "2", the %2 by "2400", and the %3
  2490.           would be replaced with the name of the upload directory and the
  2491.           filename: "C:\PUBLIC\MYSTUFF.ARC" when MyComm calls the .BAT file
  2492.           to run.
  2493.  
  2494.             External file transfer protocols often differ quite a bit, but
  2495.           they usually come with enough documentation of their own to get
  2496.           you going.
  2497.  
  2498.           NOTE: Experience has shown that some external protocol drivers
  2499.           may not release the COM port properly when they have completed
  2500.           their business.  This causes the terminal to appear "locked" (no
  2501.           characters come across the scree).  MyComm attempts to restore
  2502.           the COM port after the external protocol has been called.  If
  2503.           your terminal appears locked the COM port can be reset by using
  2504.           the <ALT> + P function from the terminal window.
  2505.  
  2506.  
  2507.           3.21.4  Miscellaneous Options Setup
  2508.  
  2509.             The Miscellaneous Options Setup screen (see example below) lets
  2510.           you set up special options for MyComm.
  2511.  
  2512.  
  2513.           MyComm Version 2.23 Documentation                 Page 45
  2514.  
  2515.  
  2516.  
  2517.  
  2518.           +------------------------------------| Misc. Options Setup |+
  2519.           |                                                           |
  2520.           | Screen Background Color:         Black                    |
  2521.           | Screen Text Color:               Gray                     |
  2522.           | Date Format Style:               MMDDYY                   |
  2523.           | 12 or 24 Hour Time Format:       12 Hour                  |
  2524.           | Make Noise When Calls Connect?:  Yes                      |
  2525.           | Make Noise After File Transfers: Yes                      |
  2526.           | Use Direct Video? (Faster):      Yes                      |
  2527.           | Your Name for sign on :          Your Name^M              |
  2528.           | Password for sign on :           Password^M               |
  2529.           | Clever quip for TagLine:         Witty quote goes here... |
  2530.           | Guess Up/Download Filenames:     Yes                      |
  2531.           |                                                           |
  2532.           |         Use Up and Down Arrows to move between items      |
  2533.           |            Hit <Enter> to edit, <Esc> to Quit             |
  2534.           +-----------------------------------------------------------+
  2535.  
  2536.  
  2537.           3.21.4.1  Screen Background Color
  2538.  
  2539.             This option tells MyComm what color to use for the screen
  2540.           background color.  This option only affects the screen of the
  2541.           terminal window.
  2542.  
  2543.  
  2544.           3.21.4.2  Screen Text Color
  2545.  
  2546.             This option tells MyComm what color to use for the screen
  2547.           foreground (the text) color.  This option only affects the screen
  2548.           of the terminal window.
  2549.  
  2550.  
  2551.           3.21.4.3  Date Format Style
  2552.  
  2553.             You may choose three date formats for MyComm to use when it
  2554.           displays dates:  MM/DD/YY,  DD/MM/YY, or YY/MM/DD.  Choose
  2555.           whichever one best fits your mood.
  2556.  
  2557.  
  2558.           3.21.4.4  12 or 24 Hour Time Format
  2559.  
  2560.             MyComm will display the time in either 12 hour or 24 hour
  2561.           format. Choose the one that bests reflects how you identify with
  2562.           time.
  2563.  
  2564.  
  2565.           MyComm Version 2.23 Documentation                 Page 46
  2566.  
  2567.  
  2568.  
  2569.           3.21.4.5  Make Noise When Calls Connect
  2570.  
  2571.             MyComm sounds a short alarm noise when a connection is made
  2572.           during dialing.  If you don't want MyComm to sound the alarm, set
  2573.           this option to "No".
  2574.  
  2575.  
  2576.           3.21.4.6  Make Noise After File Transfers
  2577.  
  2578.             MyComm sounds a short alarm noise after a file transfer has
  2579.           completed.  If you don't want MyComm to make the noise, set this
  2580.           option to "No".
  2581.  
  2582.  
  2583.           3.21.4.7  Use Direct Video
  2584.  
  2585.             MyComm by default uses a system called "direct video" when
  2586.           displaying information to the screen.  Unfortunately, direct
  2587.           video will often "bleed through" to other programs in a
  2588.           multitasking environment.  If you are using a multitasker and
  2589.           getting bleed through from MyComm, set the Direct Video option to
  2590.           "No".
  2591.  
  2592.  
  2593.           3.21.4.8  Your Name for sign on
  2594.  
  2595.             This option lets you enter the name that you log on with when
  2596.           you call systems.  When bulletin board systems answer your call
  2597.           they usually ask for your name and password.  This name becomes
  2598.           the default for "Logon Name" for new numbers you add to the
  2599.           dialing directory.  If Logon Name is filled in MyComm will send
  2600.           your logon name to systems when you push the <F2> key to save you
  2601.           some typing.
  2602.  
  2603.  
  2604.           3.21.4.9  Password for sign on
  2605.  
  2606.             This option lets you enter the password that you log on with
  2607.           when you call systems.  When bulletin board systems answer your
  2608.           call they usually ask for your password.  This password becomes
  2609.           the default for "Logon Password" for new numbers you add to the
  2610.           dialing directory.  If Logon Password is filled in MyComm will
  2611.           send your logon password to systems when you push the <F3> key to
  2612.           save you some typing.
  2613.  
  2614.  
  2615.           MyComm Version 2.23 Documentation                 Page 47
  2616.  
  2617.  
  2618.  
  2619.           3.21.4.10 Clever quip for TagLine
  2620.  
  2621.             Many BBS's have message areas where you can converse with other
  2622.           people.  If you want to be able to sign your name, leave a witty
  2623.           quote or whatever without typing it over and over for each
  2624.           message fill this area in.  When you press the <F4> key MyComm
  2625.           will send the message you have entered here.  The message can be
  2626.           up to 40 characters long.  You may also send ANSI "Escape"
  2627.           sequences (see DOS manual) from the Tagline.
  2628.  
  2629.             If you want to send the ASCII "ESCape character (27 decimal, 1B
  2630.           hex) which usually precedes ANSI escape sequences, MyComm uses
  2631.           the characters "^[ ". ("caret" sign left bracket).  For example,
  2632.           the ANSI.SYS driver recognizes the string
  2633.  
  2634.           <Esc>[5mThis is blinking<Esc>[0m
  2635.  
  2636.           as a string that blinks. (note: <Esc> represents the 27 decimal
  2637.           (1B hex) character here).  So, if your Tagline looked like
  2638.  
  2639.           ^[[5mThis is blinking^[[0m
  2640.  
  2641.           the other system would display "This is blinking" as a blinking
  2642.           message line.
  2643.  
  2644.  
  2645.           3.21.4.11 Guess Up/Download Filename
  2646.  
  2647.             By default MyComm tries to "guess" the filename that you want
  2648.           to upload or download.  MyComm will make a best guess as to what
  2649.           you most recently typed that looked like a filename.  Having this
  2650.           option set to "Yes" can save you time and typing when performing
  2651.           file transfers.
  2652.  
  2653.  
  2654.           3.21.5  COM Port Addresses
  2655.  
  2656.             This option enables changes to the COM port addresses.  By
  2657.           default MyComm uses standard addresses and Interrupt Request
  2658.           Lines (IRQ) to communicate with your modem.  Most users will
  2659.           never have a need to use this option.  It is most commonly used
  2660.           when there is a conflict with a mouse or other serial device and
  2661.           the modem.  By changing the base address and IRQ line this
  2662.           problem can often be alleviated.  Modifying the COM port address
  2663.           table and IRQ settings can be tricky.  If you are not entirely
  2664.           certain that you know what you are doing this option is best left
  2665.           alone.
  2666.  
  2667.             You will see a table with the COM port number, the base address
  2668.           it is using, and the IRQ line.  You move from field to field by
  2669.           pressing the <Enter> key.  The base address is displayed in and
  2670.  
  2671.  
  2672.           MyComm Version 2.23 Documentation                 Page 48
  2673.  
  2674.  
  2675.  
  2676.           should be entered as a hexadecimal number.  The IRQ line will
  2677.           take numbers between 2 and 7.
  2678.  
  2679.             After you make changes you will have to reinstall the COM port.
  2680.           This is done by going back to the main terminal window and
  2681.           pressing <Alt> and 'P' and following the "Change Port" menu.
  2682.  
  2683.  
  2684.           3.21.6  Restore to Defaults
  2685.  
  2686.             This option will reset the MyComm configuration information to
  2687.           it's defaults.  A message will appear warning you of this, and a
  2688.           second "Yes/No" screen will ask if you want to proceed.  The
  2689.           changes take effect immediately, but are not saved until you use
  2690.           the "Save Setup" option.
  2691.  
  2692.  
  2693.           3.21.7  Save Setup
  2694.  
  2695.             This option saves the changes you made to the various
  2696.           configuration items to the file MYCOMM.CFG.  If you make changes,
  2697.           but do not save them, the changes will only remain active until
  2698.           you exit from MyComm.
  2699.  
  2700.  
  2701.           3.22 Send Screen to File - Alt W
  2702.  
  2703.             Pressing the <ALT> and the "W" key takes a "snap shot" of the
  2704.           currently displayed terminal screen and writes it out to the file
  2705.           MYCOMM.SCR.  The resulting file will contain the text currently
  2706.           on the screen.
  2707.  
  2708.  
  2709.           3.23 Exit MyComm - Alt X
  2710.  
  2711.             Pressing the <ALT> and the "X" key brings up a message box that
  2712.           takes a Yes/No response.  Press "Y" to exit MyComm, or "N" or
  2713.           <Esc> to cancel.
  2714.  
  2715.  
  2716.           3.24 Help Screen - F1
  2717.  
  2718.             When you are in the main terminal window pressing the F1 key
  2719.           will show you a list of MyComm commands that are available to
  2720.           you.
  2721.  
  2722.  
  2723.           MyComm Version 2.23 Documentation                 Page 49
  2724.  
  2725.  
  2726.  
  2727.           3.25 Send Name - F2
  2728.  
  2729.             When bulletin board systems answer your call they usually ask
  2730.           for your name and password.  This option sends the name that you
  2731.           log on with when you call a system if your name is filled in for
  2732.           the dialing directory entry for the system.
  2733.  
  2734.  
  2735.           3.26 Send Password - F3
  2736.  
  2737.             This option sends the password that you log on with when you
  2738.           call a system. See also "Send Name" above.
  2739.  
  2740.  
  2741.           3.27 Send Tagline  - F4
  2742.  
  2743.             This is used to sign your name, or put a short quote, up to 40
  2744.           characters at the end of a message.  This is set up in the
  2745.           "Miscellaneous Options Setup" screen.
  2746.  
  2747.  
  2748.           3.28 Transferring Files
  2749.  
  2750.             MyComm has a wide variety of built in file transfer protocols
  2751.           such as  Zmodem, Xmodem, Xmodem-1K, Ymodem Batch, Ymodem-G Batch,
  2752.           SEAlink, Kermit, and of course ASCII.  There are also slots to
  2753.           include up to six external file transfer protocols if you would
  2754.           like to add more.
  2755.  
  2756.              You may Upload (send) files or Download (receive) files.  Most
  2757.           host systems will have you start the file transfer at their end
  2758.           first, and then wait for you to set up on your end.  Host systems
  2759.           usually wait about a minute or so for you to set up, so don't
  2760.           panic.
  2761.  
  2762.             All file transfer protocols on MyComm use 8-N-1 (8 data bits,
  2763.           No parity, and 1 stop bit).  MyComm automatically sets these
  2764.           settings for you before the file transfer begins, then switches
  2765.           back to what ever settings were in place before the transfer
  2766.           began.
  2767.             Except for ASCII file transfers, MyComm turns off the XON/XOFF
  2768.           flow control switch if you have it set on.  This is done to
  2769.           prevent the XON/XOFF codes as being mistaken as part of the
  2770.           incoming file.  The original state of the XON/XOFF flow control
  2771.           is restored at the end of the file transfer.  If your modem has
  2772.           its own built in XON/XOFF flow control setting, you should turn
  2773.           it off during file transfers (refer to your modem manual -
  2774.           usually the &K option).
  2775.  
  2776.  
  2777.           MyComm Version 2.23 Documentation                 Page 50
  2778.  
  2779.  
  2780.  
  2781.             File transfers differ slightly from one host system to another.
  2782.           Basically you need to know three things:
  2783.  
  2784.                ■    whether you want to Upload (send) or Download (receive)
  2785.                     a file
  2786.  
  2787.                ■    the name of the file you want to send or receive
  2788.  
  2789.                ■    which file transfer protocol you want to use
  2790.  
  2791.             Probably you can figure out for yourself whether you are
  2792.           uploading or downloading from a system, and what the file name is
  2793.           that you want to transfer.  However you and the host system MUST
  2794.           use the same file transfer protocol or the transfer will fail.
  2795.           The tricky part sometimes is deciding which file transfer
  2796.           protocol to use.  There are so many!
  2797.  
  2798.             Actually it's easy to decide which file transfer protocol you
  2799.           want to use.  When you request a file transfer from the host
  2800.           system, they usually show you a list of file transfer protocols
  2801.           that their system supports.  Just pick one that both MyComm and
  2802.           the host system support, and you're on your way!
  2803.  
  2804.             The two most frequently used protocols are Xmodem and Zmodem.
  2805.           A little experimentation on your part will help you decide which
  2806.           of the file transfer protocols best meets your needs.
  2807.  
  2808.             A description of each of the file transfer protocols that
  2809.           MyComm supports will be found later in this section.
  2810.  
  2811.           3.28.1  Starting a File Transfer
  2812.  
  2813.             The steps to start the file transfer from your end with MyComm
  2814.           are simple:
  2815.  
  2816.                ■    Press PgUp to send files, or PgDn to receive files
  2817.  
  2818.                ■    Choose the file transfer protocol you want to use from
  2819.                     the menu
  2820.  
  2821.                ■    Type in the filename (if needed)
  2822.  
  2823.                ■    The file transfer will start and display a status
  2824.                     window
  2825.  
  2826.                ■    When the file transfer completes MyComm makes a noise
  2827.  
  2828.             MyComm's file transfer menus and screens look basically the
  2829.           same for both uploads and downloads.  When you press PgUp or PgDn
  2830.           a menu pops up showing you the different file transfer protocol
  2831.  
  2832.  
  2833.           MyComm Version 2.23 Documentation                 Page 51
  2834.  
  2835.  
  2836.  
  2837.           options you have (see example below).  Pick a protocol, or press
  2838.           the <Esc> or "Q" key to cancel.
  2839.  
  2840.           Download Protocol Menu Example
  2841.  
  2842.                                   +------| Down Load |+
  2843.                                   | ASCII             |
  2844.                                   | SEAlink Derived   |
  2845.                                   | Xmodem            |
  2846.                                   | 1K-Xmodem         |
  2847.                                   | Real Ymodem Batch |
  2848.                                   | Ymodem Batch - 1K |
  2849.                                   | Zmodem            |
  2850.                                   | Kermit            |
  2851.           external protocol ==>   | 1: BIGFAST        |
  2852.           (example)               | Quit/None         |
  2853.                                   +-------------------+
  2854.  
  2855.             After you pick a file transfer protocol, MyComm will ask you
  2856.           for the filename that you want to send or receive.  Some of the
  2857.           file transfer protocols for receiving files, such as Ymodem Batch
  2858.           and Zmodem, don't need to ask you the file name so you may not
  2859.           always be asked for a filename.  MyComm ALWAYS asks for the
  2860.           filename when you upload files.
  2861.  
  2862.           Note:
  2863.             When you upload files with the "batch" protocols you may also
  2864.           use the DOS "wildcard" characters for filenames such as *.* or
  2865.           ALL*.ARC, or FILE??.*, etc.
  2866.  
  2867.             If the filename, or the path to the file (the directory) are
  2868.           invalid or can't be found you will see an error message and you
  2869.           may re-enter the filename.  If you want to exit without
  2870.           performing the file transfer press the <Esc> key.
  2871.  
  2872.             When the filename is entered correctly MyComm will start the
  2873.           file transfer and the File Transfer Status Window shown below
  2874.           will pop up.
  2875.  
  2876.  
  2877.           MyComm Version 2.23 Documentation                 Page 52
  2878.  
  2879.  
  2880.  
  2881.           Download/Upload Status Window
  2882.  
  2883.           +------------------------------------------| Ymodem Download |+
  2884.           |                                                             |
  2885.           | Receiving: D:\PUBLIC\SOMEFILE.EXT                           |
  2886.           | ----------------------------------------------------------- |
  2887.           |                                                             |
  2888.           | Xfer Time:     0:04:18        Bytes Received:   14567       |
  2889.           | Elapsed Time:  0:01:18        Bytes Expected:   58645       |
  2890.           | Approx. CPS:       186        Blocks Sent:        114       |
  2891.           | ----------------------------------------------------------- |
  2892.           |                                                             |
  2893.           | Error Count: 0                Error Correction: CRC-16      |
  2894.           | Last Error Message: Receiving File                          |
  2895.           |                                                             |
  2896.           +-------------------------------------------------------------+
  2897.  
  2898.  
  2899.             The status window displays information about the file transfer
  2900.           such as the file name being sent/received, an estimate of how
  2901.           long it will take to do the transfer, the elapsed time, the CPS
  2902.           rate (Characters Per Second), the bytes sent/received, the blocks
  2903.           sent, error correction type, and error status.
  2904.  
  2905.           Note:
  2906.             Some protocols will not tell you the Xfer Time or the Bytes
  2907.           Expected during downloads.  This is because some protocols do not
  2908.           send an information "header" packet that tells MyComm how many
  2909.           bytes to expect from the sender.
  2910.  
  2911.             When MyComm calculates the amount of time a transfer will take
  2912.           it does the calculation based on a "worst case" rate of 80%
  2913.           efficiency. This is to take into consideration possible line
  2914.           noise, packet resends, and other considerations.  Actual file
  2915.           transfers may be faster than what MyComm calculates.
  2916.  
  2917.             The CPS rate reflects only the number of bytes actually
  2918.           sent/received from/to the file.  Overhead bytes such as CRC and
  2919.           "escape" characters are not included in the calculation.  This
  2920.           provides a more realistic picture of the file transfer progress.
  2921.  
  2922.  
  2923.           MyComm Version 2.23 Documentation                 Page 53
  2924.  
  2925.  
  2926.  
  2927.           3.28.2  File Transfer Hints
  2928.  
  2929.                ■    Both the sender and receiver MUST use the same file
  2930.                     transfer protocol
  2931.  
  2932.                ■    If a file transfer keeps aborting using one protocol on
  2933.                     a host system, try using a different one.
  2934.  
  2935.                ■    It is not a good idea to upload or download from floppy
  2936.                     disk.  Floppy drives are slow, so the read and write
  2937.                     access time will slow down the transfer.  Floppy drives
  2938.                     do not hold very much data.  If the floppy disk were to
  2939.                     fill up during a download, the transfer would be
  2940.                     aborted.
  2941.  
  2942.  
  2943.           3.28.3  Download Files - PgDn
  2944.  
  2945.               Pressing the PgDn (Page Down) key starts the file download
  2946.           procedures previously discussed.
  2947.  
  2948.  
  2949.           3.28.4  UpLoad Files - PgUp
  2950.  
  2951.               Pressing the PgUp (Page Up) key starts the file upload
  2952.           procedures previously discussed.
  2953.  
  2954.  
  2955.           3.28.5  ASCII File Transfers
  2956.  
  2957.             ASCII file transfers are only used to transfer text files.
  2958.           Program files, also known as binary files, should not be
  2959.           transferred as ASCII files.  ASCII uploads do not show the File
  2960.           Transfer Status Window unless you have set the "Show Upload"
  2961.           option to "No" in the ASCII Xfer configuration menu.  ASCII
  2962.           transfers have no error correction, but just plough along as
  2963.           though the characters were actually being typed from the
  2964.           keyboard.  This is commonly referred to as a "send and pray"
  2965.           protocol.
  2966.  
  2967.             During ASCII downloads, the download continues until either a
  2968.           Ctrl-Z (end of file marker) is received, or no characters have
  2969.           been received for 10 seconds.  You may also stop the transfer at
  2970.           any time by pressing the <ESC> key.
  2971.  
  2972.  
  2973.           MyComm Version 2.23 Documentation                 Page 54
  2974.  
  2975.  
  2976.  
  2977.           3.28.6  SEAlink Derived File Transfers
  2978.  
  2979.             SEAlink is an advanced version of Xmodem developed by System
  2980.           Enhancement Associates.  SEAlink uses a "sliding window" protocol
  2981.           which sends ahead several packets while waiting for an
  2982.           acknowledgement from the receiver.  This can result in transfers
  2983.           that are 10 to 20 percent faster than plain Xmodem.  SEAlink
  2984.           sends the file name and file size when the transfer starts up,
  2985.           and can be used to send more than one file at a time.
  2986.  
  2987.             The version of SEAlink that MyComm uses is known as "Derived
  2988.           SEAlink" as MyComm does not support the "overdrive" option which
  2989.           is only used in half-duplex links.
  2990.  
  2991.  
  2992.           3.28.7  Xmodem File Transfers
  2993.  
  2994.             Xmodem is probably the most widely used protocol today.  Xmodem
  2995.           was originally developed by Ward Christensen in the summer of
  2996.           1977 for use on CP/M machines, and was soon ported to the MS-DOS
  2997.           environment.  Xmodem sends data in 128 byte blocks.  The block
  2998.           count seen in the File Transfer Status Window shows the number of
  2999.           128 byte blocks that have been transferred.  This has
  3000.           euphemistically been called "Xmodem blocks" and has become
  3001.           somewhat of a standard in P.C. data communications.
  3002.  
  3003.             Xmodem has two flavors; Check Sum and CRC-16 mode.  MyComm
  3004.           supports both Check Sum and CRC-16 mode, and automatically
  3005.           selects the correct one to use.  The check sum mode is not nearly
  3006.           as reliable as CRC-16, and isn't used as often.
  3007.  
  3008.           3.28.8  1K-Xmodem File Transfers
  3009.  
  3010.             Xmodem-1K is a variation of Xmodem which uses a 1K (1024 byte)
  3011.           block to send data.  Under most conditions Xmodem-1K is slightly
  3012.           faster than plain Xmodem.  If there is a lot of line noise
  3013.           however, the throughput can degrade due to having to perform a
  3014.           resend on the larger packet.
  3015.  
  3016.             Some older host systems may refer to Xmodem-1K as "Ymodem" so
  3017.           read the host system menu carefully.
  3018.  
  3019.  
  3020.           MyComm Version 2.23 Documentation                 Page 55
  3021.  
  3022.  
  3023.  
  3024.           3.28.9  Ymodem Batch File Transfers
  3025.  
  3026.             The Ymodem Batch protocol can perform either single or batch
  3027.           file transfers.  That is, it can send or receive one or more
  3028.           files in a transfer session.  Ymodem Batch starts sessions by
  3029.           sending the file name and size to the receiver, then sends the
  3030.           file data.  Ymodem uses both a 128 byte or 1024 byte (1K) packet
  3031.           size and MyComm chooses the correct packet size to use during the
  3032.           transfer.
  3033.  
  3034.  
  3035.           3.28.10  Ymodem-G Batch File Transfers
  3036.  
  3037.             The Ymodem-G Batch protocol is similar to the regular Ymodem
  3038.           Batch protocol. The difference is that Ymodem-G performs no error
  3039.           correction what-so-ever and as such it is generally only used
  3040.           with error correcting modems, or Null modem cables.  If an error
  3041.           is detected during a transfer, the transfer is immediately
  3042.           aborted.
  3043.  
  3044.  
  3045.            3.28.11 Zmodem File Transfers
  3046.  
  3047.             Zmodem is another widely used file transfer protocol.  It was
  3048.           developed by Chuck Forsberg/Omen Technology, Inc.  Zmodem is an
  3049.           extremely robust protocol as it recovers from errors well and
  3050.           will try to keep the file transfer session going under adverse
  3051.           conditions.
  3052.  
  3053.             Zmodem will perform both single file and batch (multiple) file
  3054.           transfers.  Like Ymodem, when receiving a file using Zmodem, you
  3055.           don't have to type in the file name on your end.  Zmodem sends
  3056.           the filename as part of a special "header" that MyComm
  3057.           recognizes.
  3058.  
  3059.             Zmodem uses either a 16 bit or 32 bit CRC (Cyclic Redundancy
  3060.           Check) when transferring the file.  You will see the CRC type
  3061.           displayed in the File Transfer Status Window.  The CRC is used
  3062.           for error checking during the transfer.  MyComm automatically
  3063.           selects the proper CRC type to use so you don't have to worry
  3064.           about it.  The 16 bit CRC transfers often go a little faster than
  3065.           32 bit CRC transfers.  However the 32 bit CRC is much more
  3066.           reliable for error correction, and well worth the few seconds
  3067.           added to the transfer time.
  3068.  
  3069.  
  3070.           MyComm Version 2.23 Documentation                 Page 56
  3071.  
  3072.  
  3073.  
  3074.            3.28.12 Kermit File Transfers
  3075.  
  3076.             The Kermit file transfer protocol is widely used in many
  3077.           environments in particular mainframes and mini mainframes.
  3078.           Kermit was designed to allow many different types of machines to
  3079.           send data to each other.  In order to do this Kermit places a
  3080.           special "escape" character before any control characters
  3081.           encountered.  However this compatibility does have its price,
  3082.           Kermit is one of the slowest protocols in use today.  Because of
  3083.           the slow file transfers Kermit should be used when there is no
  3084.           other protocol available.  The Kermit version in MyComm supports
  3085.           the "basic" Kermit protocol.
  3086.  
  3087.  
  3088.           3.28.13 External Protocol File Transfers
  3089.  
  3090.               MyComm lets you define up to six external file transfer
  3091.           protocols.  The external file transfer protocols will also appear
  3092.           in the Upload and Download protocol selection menus.
  3093.  
  3094.             External protocols are set up in the External Protocols Setup
  3095.           (see section 3.20.3.3 "External Protocols Setup").  External
  3096.           protocols differ from vendor to vendor, so you should refer to
  3097.           the particular protocol's documentation for more detailed
  3098.           installation instructions.  MyComm invokes the external protocols
  3099.           through the use of DOS "batch" files.  Parameters are passed to
  3100.           the batch file in the following order: COM Port number (0 to 7),
  3101.           BPS rate, and Drive:\Path\Filename which translate to batch
  3102.           parameters %1, %2, and %3.
  3103.  
  3104.  
  3105.           3.28.14 MyComm as a Host
  3106.  
  3107.             At this point in time MyComm does not have a "host" mode per
  3108.           Se.  This was a design decision in order to keep the code size
  3109.           small. However, there is a file called MCHOST.SCP which is a
  3110.           MyComm script that will perform very simple host functions.  The
  3111.           MCHOST.SCP file may be used as an example to create your own host
  3112.           scripts as well. Please note that MyComm is not intended for use
  3113.           as a BBS, but the MCHOST.SCP should provide enough functionality
  3114.           for simple file transfers.  See also Appendix E - Script
  3115.           Language.
  3116.  
  3117.             It is also possible to transfer files between two MyComm
  3118.           programs (or MyComm and another communication program) without
  3119.           the use of a special script file.  To do this one person acts as
  3120.           the "host", and the other as caller.  As the caller you would
  3121.           just call the other person as you would for any other bulletin
  3122.           board system.
  3123.  
  3124.  
  3125.           MyComm Version 2.23 Documentation                 Page 57
  3126.  
  3127.  
  3128.  
  3129.           For this example, let's say you're the host since that's the
  3130.           complicated part.
  3131.  
  3132.           Step 1:   Prearrange a time for the other person to call you.
  3133.  
  3134.           Step 2:   Get MyComm up and running.
  3135.  
  3136.           Step 3:   When the other person calls you will hear the phone
  3137.                     ringing or see the word "RING" appear on the MyComm
  3138.                     terminal screen.  When you see "RING", type ATA then
  3139.                     press the <Enter> key.  This tells your modem to answer
  3140.                     the phone and initiate the carrier tones so the two
  3141.                     modems will "talk" to each other.  Alternatively you
  3142.                     could press <Alt> and the "I" key, then press "A" for
  3143.                     the "Send Answer String" command.
  3144.  
  3145.           Step 3a:  Alternative to Step 3: before the other person calls
  3146.                     type ATS0=1 then press <Enter>.  This tells your modem
  3147.                     to answer the modem on the first ring and to initiate
  3148.                     the carrier tones.
  3149.  
  3150.           Step 4:   When transferring files from one MyComm to another
  3151.                     remember that when they are uploading, you are
  3152.                     downloading and vice versa.  So if the other person
  3153.                     wants to download a file from you they would start the
  3154.                     download function at their end, and you would start an
  3155.                     upload from your end.  The most important things to
  3156.                     decide before doing the transfer are:
  3157.  
  3158.                       - who is uploading/downloading to and from who
  3159.  
  3160.                       - which file transfer protocol you are using (they
  3161.                         MUST be the same)
  3162.  
  3163.                       - and finally, what the filename is.
  3164.  
  3165.           Step 4a   This is where the MyComm "chat" mode can be handy.  It
  3166.                     can help you establish stuff while you're on-line with
  3167.                     the other person.  If you would like to "chat" on-line
  3168.                     with the other person, Press <Alt> and the "A" key to
  3169.                     bring up the MyComm split screen chat mode (see section
  3170.                     3.3 "Chat Mode").
  3171.  
  3172.           Step 5:   If all goes smoothly the file transfer will be
  3173.                     successful.  In fact for the most part it will be as
  3174.                     though you had simply called another BBS, except this
  3175.                     time you're interacting with a live person rather than
  3176.                     the BBS software.
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.           Appendix A - MyComm Command Summary
  3184.  
  3185.                     Alt A - Chat Mode
  3186.                     Alt B - Send Break
  3187.                     Alt C - Clear the Screen
  3188.                     Alt D - Dialing Functions
  3189.                     Alt E - Local Echo On/Off
  3190.                     Alt F - Toggle Line Feed On/Off
  3191.                     Alt H - Hang Up Modem
  3192.                     Alt I - Send Modem Initialization Strings
  3193.                     Alt J - Join Script (Run a Script)
  3194.                     Alt L - Present Line Status
  3195.                     Alt K - Scroll Back
  3196.                     Alt M - Manual Dial
  3197.                     Alt O - Outside to DOS
  3198.                     Alt P - Change Port Parameters
  3199.                     Alt Q - Quick Re- Dial
  3200.                     Alt R - Run External Program
  3201.                     Alt S - Session Capture On/Off/Pause
  3202.                     Alt T - Terminal Emulation
  3203.                     Alt U - Update Configuration
  3204.                     Alt W - Send Screen to File
  3205.                     Alt X - Exit MyComm
  3206.  
  3207.                     F1    - Help Screen
  3208.                     F2    - Send Name
  3209.                     F3    - Send Password
  3210.                     F4    - Send Tagline
  3211.  
  3212.                     PgUp  - Upload Files
  3213.                     PgDn  - Download Files
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.           Appendix B - MyComm Line Editing Functions
  3221.  
  3222.             Many of the user configuration options and the dialing list
  3223.           have sections that require a line of text to be input and edited.
  3224.           MyComm has a built in line editor to perform simple editing on
  3225.           these text lines.  The MyComm line editor uses a tiny subset of
  3226.           WordStar type commands.  A description of the line edit commands
  3227.           follows.
  3228.  
  3229.           ■ Enter       -     Terminates editing the line and keeps it
  3230.  
  3231.           ■ Esc         -     Terminates editing the line and does not keep
  3232.                               it
  3233.  
  3234.           ■ Right Arrow -     Moves the cursor right.
  3235.  
  3236.           ■ Left Arrow  -     Moves the cursor left.  This is "non-
  3237.                               destructive", the character is not erased as
  3238.                               the cursor moves
  3239.  
  3240.           ■ BackSpace   -     Moves the cursor left.  This is
  3241.                               "destructive", the character is erased as the
  3242.                               cursor moves
  3243.  
  3244.           ■ End         -     Positions the cursor at the end of the line
  3245.  
  3246.           ■ Home        -     Positions the cursor at the beginning of the
  3247.                               line
  3248.  
  3249.           ■ Ctrl + T    -     When the Ctrl key and the letter T are
  3250.                               pressed simultaneously, the line is erased
  3251.                               from the current cursor position to the end
  3252.                               of the line
  3253.  
  3254.           ■ Ctrl + Y    -     When the Ctrl key and the letter Y are
  3255.                               pressed simultaneously, the entire line is
  3256.                               erased and the cursor is positioned at column
  3257.                               one
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.           Appendix C - Terminal Emulation
  3265.  
  3266.             This is a list of the functions that MyComm supports in the
  3267.           terminal emulators.
  3268.  
  3269.           1.0  TTY Terminal Emulation
  3270.  
  3271.             TTY does not provide any character translation what-so-ever.
  3272.           The characters are simply displayed as they come in.
  3273.  
  3274.  
  3275.           2.0  ANSI Terminal Emulation
  3276.  
  3277.  
  3278.             ANSI provides mapping similar to that found in your ANSI.SYS
  3279.           driver.  The color and screen attributes as described in the
  3280.           "MS-DOS 5.0 User's Guide and Reference" are supported, except for
  3281.           the keyboard mapping functions.  The following keys also generate
  3282.           codes recognized by other systems operating in ANSI mode:
  3283.  
  3284.             Direction (Arrow) Keys  - move cursor
  3285.             Delete                  - sends DEL (127 decimal)
  3286.             End                     - erase to end of line
  3287.             Home                    - homes cursor
  3288.             Ctrl-Home               - clears screen, and homes cursor
  3289.             Function Keys           - do not generate a character
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.           3.0  VT-52 and VT-100 Terminal Emulation
  3297.  
  3298.  
  3299.  
  3300.             The VT-52 and VT-100 emulations are typically used with
  3301.           mainframe environments.  These emulations provide a subset of the
  3302.           "application keyboard" functions defined in the "VT-200
  3303.           Programmer Guide", Digital #EK-VT220-HR-001.  These emulations
  3304.           will work in either a 7 or 8 bit environment.  A standard key pad
  3305.           for these terminals looks like this:
  3306.  
  3307.               +-----------------------+
  3308.               | PF1 | PF2 | PF3 | PF4 |
  3309.               |-----+-----+-----+-----|
  3310.               |  7  |  8  |  9  |  -  |
  3311.               |-----+-----+-----+-----|
  3312.               |  4  |  5  |  6  |  ,  |
  3313.               |-----+-----+-----+-----|
  3314.               |  1  |  2  |  3  |  R  |
  3315.               |-----------+-----|  T  |
  3316.               |     0     |  .  |  N  |
  3317.               +-----------------------+
  3318.  
  3319.             MyComm defines these keys as follows:
  3320.  
  3321.             PF1 through PF4     - <SHIFT> + F1 through F4
  3322.             1 through 0         - <ALT> + F1 through F10
  3323.             Minus Sign "-"      - <SHIFT> + F5
  3324.             Comma ","           - <SHIFT> + F6
  3325.             Decimal Point "."   - <SHIFT> + F7
  3326.             RTN (Enter key)     - <SHIFT> + F8
  3327.  
  3328.           NOTE: the above keys are the function keys on a standard PC
  3329.           keyboard.  The PC numeric keypad has not been mapped to these
  3330.           keys.
  3331.           Also defined:
  3332.  
  3333.             Direction (Arrow) Keys  - move cursor
  3334.             Delete                  - sends DEL (127 decimal)
  3335.             End                     - erase to end of line
  3336.             Home                    - homes cursor
  3337.             Ctrl-Home               - clears screen, and homes cursor
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.           4.0  3270 Terminal Emulation (Registered version only)
  3345.  
  3346.  
  3347.             This emulation is most commonly used when connecting to IBM
  3348.           mainframe hosts.  This emulation should be used instead of VT-100
  3349.           emulation when connecting through a 7171 protocol converter.
  3350.           This emulation works best with 101 key PC keyboards (to get the
  3351.           PF11, PF12, PF23, and PF24 keys).  The mapping to the PC keyboard
  3352.           follows.
  3353.  
  3354.           PC Keypad         Alternate            3270 emulation
  3355.  
  3356.           <Shift> + F1                           PF1
  3357.              ...                                 ...
  3358.              ...                                 ...
  3359.           <Shift> + F10                          PF10
  3360.           <Shift> + F11    <Esc> + -             PF11
  3361.           <Shift> + F12    <Esc> + =             PF12
  3362.  
  3363.           <Alt> + F1                             PF13
  3364.              ...                                 ...
  3365.              ...                                 ...
  3366.           <Alt> + F10                            PF22
  3367.           <Alt> + F11      <Esc> + _             PF23
  3368.           <Alt> + F12      <Esc> + +             PF24
  3369.  
  3370.           <Ctrl> + F1                            PA1
  3371.              ...                                 ...
  3372.              ...                                 ...
  3373.           <Ctrl> + F4                            PA4
  3374.  
  3375.           Arrow Keys                         Arrow Keys
  3376.           Insert                             Toggle Insert
  3377.           <Shift> + <Tab>                    Back Tab
  3378.           <Ctrl> + <Left Arrow>              BackSpace
  3379.           Home                               Home
  3380.           Delete                             DEL
  3381.           <Ctrl> + Home                      CLEAR
  3382.           End                                Erase to End of field
  3383.           <Ctrl> + End                       Line Feed
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.           Appendix D - Troubleshooting
  3391.           This section should answer common problems that you might have
  3392.           when using MyComm.
  3393.  
  3394.  
  3395.           Problem:  - Modem doesn't respond at all, responds
  3396.                       intermittently, or behaves strangely.
  3397.  
  3398.           Possible Causes:
  3399.  
  3400.             -  Is the COM port the right one?  i.e COM 1, 2, 3, 4, 5, 6, 7,
  3401.                or 8.
  3402.  
  3403.             -  Is the modem installed correctly?
  3404.  
  3405.             -  If this is an external modem, are the cables hooked up? Is
  3406.                it plugged in and switched on?
  3407.  
  3408.             -  Is the modem really Hayes (Tm) compatible?
  3409.  
  3410.             -  Is the initialization string correct for the modem?  The
  3411.                manual that came with your modem will list the "AT" commands
  3412.                that are valid.
  3413.  
  3414.             -  Is the baud rate entered in the "Modem Setup" screen less
  3415.                than or equal to the top speed of the modem?  For example, a
  3416.                2400 bps modem will not initialize correctly if the baud
  3417.                rate is set to 19200.
  3418.  
  3419.             -  Is there another serial device such as a mouse, multi-I/O
  3420.                card, or a sound card that is sharing the same IRQ line as
  3421.                the modem?  This is a very common problem. So common in fact
  3422.                that several paragraphs are devoted to it.
  3423.                  COM1 and COM3 both share IRQ4, and COM2 and COM4 both
  3424.                share IRQ3. You can not hook up a serial device such as a
  3425.                mouse to COM1 and the modem to COM3 and expect them to work
  3426.                correctly (the same is true for COM2 and COM4). Often a
  3427.                multi-I/O cards will come with COM2 enabled which will
  3428.                conflict with your modem if you attempt to use the modem on
  3429.                either COM2 or COM4.
  3430.                  The solution is to set the offending card or the modem to
  3431.                a different IRQ line than one that is currently in use.
  3432.                This is generally performed by re-configuring the jumper
  3433.                settings on the card or modem.  The store where you bought
  3434.                your card from or the manual(s) that came with the card or
  3435.                modem will describe how to do this.  Many newer modems can
  3436.                be re-jumpered for IRQ2 or IRQ5. If you change the IRQ line
  3437.                settings on the modem be sure to change the configuration in
  3438.                MyComm as well (see below and the section titled "COM Port
  3439.                Addresses").
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.             -  MyComm uses default address and interrupt vectors for COM
  3448.                Ports of:
  3449.  
  3450.                COM Port   Address  IRQ Line
  3451.                   1        3F8        4
  3452.                   2        2F8        3
  3453.                   3        3E8        4
  3454.                   4        2F8        3
  3455.                   5        3E8        2
  3456.                   6        2F8        2
  3457.                   7        3E8        5
  3458.                   8        2F8        5
  3459.  
  3460.                If you have set these to something different, MyComm
  3461.           probably won't like it.  Reset the interrupt vectors to their
  3462.           standard settings.  If you don't know what this means, you
  3463.           probably didn't fool with it in the first place, so don't mess
  3464.           with it now.
  3465.  
  3466.             MyComm allows user configuration of addresses or interrupt
  3467.           vectors on the COM ports.  See the section "COM Port Addresses"
  3468.           for more information.
  3469.  
  3470.  
  3471.           Problem:  - Modem won't hang up the phone line.
  3472.  
  3473.           Possible Causes:
  3474.  
  3475.             -  Some modems have a DIP switch setting that keeps Carrier
  3476.                Detect always on.  MyComm uses the Carrier Detect signal
  3477.                (CD) to see if it's on-line, and to see when the modem has
  3478.                released the phone line.  You should set your modem to let
  3479.                software, in this case MyComm, to handle the Carrier Detect
  3480.                signal.
  3481.  
  3482.             -  Try adding the Hayes command "&C1" (without the quotes) to
  3483.                your initialization string.  This tells the modem to raise
  3484.                Carrier Detect only when connected.
  3485.  
  3486.  
  3487.           Problem:  - Modem dials, but doesn't know when the connection has
  3488.                       been made.
  3489.  
  3490.           Probable Causes:
  3491.  
  3492.             -  Make certain that the modem is sending text responses rather
  3493.                than numeric.  Add "Q0" and "V1" to your modem
  3494.                initialization string.
  3495.  
  3496.             -  Go into the "Modem Setup" screen and check the "Connect
  3497.                Strings" setting.  Make sure that they look like the ones
  3498.                your modem usually generates.
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.           Problem:  - The result codes from the modem are numbers instead
  3507.                       of text.
  3508.  
  3509.           Possible Causes:
  3510.  
  3511.             -  Try adding "Q0" and "V1" to the modem initialization string.
  3512.                MyComm MUST see the result codes, and they have to be the
  3513.                English Text.  Also try adding "X4" to the initialization
  3514.                string.
  3515.  
  3516.  
  3517.           Problem:  - When using a multitasker such as Windows (Tm),
  3518.                       DoubleDOS (Tm), etc, the MyComm displays bleed
  3519.                       through to other applications.
  3520.  
  3521.           Possible Causes:
  3522.  
  3523.             -  Set the option "Direct Screen Writes" in the "Miscellaneous
  3524.                Options" screen to "No".
  3525.  
  3526.  
  3527.           Problem:  - When I call some services, the characters look weird,
  3528.                       or just garbage.
  3529.  
  3530.           Possible Causes:
  3531.  
  3532.             -  Make sure that the Baud Rate, Data Bits, etc. are set
  3533.                correctly. Most public BBS's use 8-N-1, but some may use 7-
  3534.                E-1 (often true with Unix (Tm) based systems and
  3535.                mainframes).
  3536.  
  3537.             -  Are you using the correct terminal emulation? See <ALT> +T
  3538.                command.
  3539.  
  3540.             -  This is sometimes caused by a COM port or IRQ line conflict.
  3541.                If another serial card or device is on the same COM port or
  3542.                IRQ line you may experience dropped characters, weird things
  3543.                happening during file transfers and other problems. See also
  3544.                question # 1 above.
  3545.  
  3546.  
  3547.           Problem:  - File transfers seem to always time out or abort.
  3548.  
  3549.           Possible Causes:
  3550.  
  3551.             -  MyComm will abort a transfer if there are too many errors in
  3552.                the transfer due to line noise, or other unpredictable
  3553.                circumstances.
  3554.  
  3555.             -  Are you and the other guy are using the same file transfer
  3556.                protocol?
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.           Problem:  - On some host systems the Word wrap or the linefeeds
  3564.                       look odd.
  3565.  
  3566.           Possible Causes:
  3567.  
  3568.             -  Is the "LF After CR" set? It is possible that the other
  3569.                system is sending Line Feeds after Carriage Return and you
  3570.                are getting double linefeed characters.  You can also turn
  3571.                the Line Feeds off (or on) by pressing Alt + F in the main
  3572.                terminal window.
  3573.  
  3574.             -  MyComm uses a screen width of 80 columns by 25 lines. As
  3575.                incoming text is displayed MyComm will scroll to the next
  3576.                line when either a linefeed character is received or when
  3577.                the cursor reaches column 80. Some host systems will send
  3578.                characters all the way out to column 79 with column 80 being
  3579.                a linefeed. In this case the text will appear to "wrap" too
  3580.                soon and you may see the line scroll down twice. In this
  3581.                case tell the host system through it's "user setup" that you
  3582.                want a screen width of only 79 characters to prevent the
  3583.                premature wrapping.
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.           Appendix E - MyComm Script Language
  3591.  
  3592.           1.0  Script Language Introduction
  3593.  
  3594.               This Appendix describes the format and syntax of the script
  3595.           language used by MyComm.  The MyComm script language is a series
  3596.           of commands in a text file that is read by MyComm to perform
  3597.           certain functions.  For example, a script function could send
  3598.           your name and password automatically when you log onto a system,
  3599.           then perform steps to navigate through the host system menus to
  3600.           gather your mail for you and then log off.
  3601.  
  3602.             The script language used in MyComm consists of 22 commands that
  3603.           are used to build scripts.  The script language is very simple,
  3604.           yet very powerful.  It is designed in such a way that ordinary
  3605.           people rather than programmers or technicians will find it easy
  3606.           to use and understand.  MyComm's script language should be no
  3607.           more difficult to use than writing DOS batch files.
  3608.  
  3609.  
  3610.           1.2  Creating a Script
  3611.  
  3612.             Scripts are created using a line editor, text editor, or word
  3613.           processing software that can save files as plain unformatted
  3614.           text.  It is similar to creating DOS "batch" files.
  3615.  
  3616.           To Create a Script
  3617.  
  3618.           Step 1:   Log onto the BBS or system that you want to create a
  3619.                     script for.  As you log on write down the sequence of
  3620.                     questions and responses that you receive and send.  For
  3621.                     example if the host system has a prompt that says
  3622.                     "Enter your Name:" and you type in your name at that
  3623.                     point, write down the question asked by the host system
  3624.                     and your response.  Optionally you may turn on the
  3625.                     Session Capture (ALT + "S") to save your responses for
  3626.                     later referral.
  3627.  
  3628.  
  3629.           Step 2:   Log off the BBS or system. No sense in tying up their
  3630.                     line.
  3631.  
  3632.           Step 3:   Use your text editor to write the script file.  The
  3633.                     script commands that MyComm understands are described
  3634.                     later in this Appendix.  The script file must be saved
  3635.                     to the same directory that the MyComm program is in
  3636.                     (for example C:\MYCOMM) so that MyComm can find it
  3637.                     later.
  3638.  
  3639.           Step 4:   Test your script with the MyComm Script Checker,
  3640.                     SCP_CHK.EXE (described later in this Appendix).  Revise
  3641.                     the script and re-test as necessary.
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.           Step 5:   Go to the Dialing Directory and edit the dialing entry
  3649.                     for this BBS.  There is an option called "Scripts".
  3650.                     Add the name of your script file here.
  3651.  
  3652.           Step 6:   Call the BBS and test your script.  Sometimes it may
  3653.                     take more than one try to get it all right.  Don't
  3654.                     worry, it happens to us all.
  3655.  
  3656.           2.0  Script Language
  3657.  
  3658.             The MyComm script language consists of 22 commands which will
  3659.           be described shortly.  The script files that you create must have
  3660.           the file name extension .SCP, and must be saved in the same
  3661.           directory that MyComm is in.  For example if you created a script
  3662.           for MyBbs, the script file would be named MYBBS.SCP.
  3663.  
  3664.             This manual will use the following conventions to describe the
  3665.           functions and the parameters that they take:
  3666.  
  3667.                FUNCNAME()     Function name is all CAPS. Please note that
  3668.                               no function name is over eight characters
  3669.                               long. All functions have the parameters
  3670.                               enclosed with parenthesis.  The parameters
  3671.                               are separated with commas.
  3672.  
  3673.                <int>          Integer parameter.
  3674.  
  3675.                <"string">     String parameter.  Please note that all
  3676.                               incoming and outgoing strings may be a
  3677.                               maximum of 60 characters in length.  Strings
  3678.                               are case sensitive, "PassWord" and "password"
  3679.                               are different strings!  Also note that the
  3680.                               strings are enclosed in quotes.  Since commas
  3681.                               are used as parameter delimiters, strings
  3682.                               must not contain embedded commas!
  3683.  
  3684.                <op1|op2|...>  Operator parameter.  Some functions use an
  3685.                               operator.
  3686.  
  3687.                <"label">      Label name.
  3688.  
  3689.                <Sn>           Parameter may be one of the string flags S0
  3690.                               through S9.
  3691.  
  3692.                <In>           Parameter may be one of the integer flags I0
  3693.                               through I9.
  3694.  
  3695.                (optional)     Indicates the next parameter is optional
  3696.  
  3697.                <"string"|Sn>  Parameter may either be a string constant or
  3698.                               one of the string flags.
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.                :label         Label within the script file.  All labels are
  3707.                               preceded by a colon ':' character.  Labels
  3708.                               may be up to eight (8) characters.
  3709.  
  3710.                comments       Comments are preceded by a semi-colon ';'.
  3711.                               The comments are free form and may be placed
  3712.                               anywhere.  The rest of the line after the
  3713.                               semi-colon is ignored by the script.
  3714.  
  3715.             The script functions are described in the following sections.
  3716.           The format of the descriptions is the function name, the
  3717.           parameter it takes, and a description. For example:
  3718.  
  3719.                WAITFOR(int waitsecs, "string"|Sn, (optional) "label"|Sn)
  3720.  
  3721.           indicates that the WAITFOR function takes an integer parameter, a
  3722.           string or "S" flag parameter, and an optional string or "S" flag
  3723.           parameter.
  3724.           2.1  Special Script Characters
  3725.  
  3726.             There are several special characters that MyComm will interpret
  3727.           for you when they are put into strings that you are sending to
  3728.           the host system:
  3729.  
  3730.           ^M ("caret" sign and capital "M")       This character sequence
  3731.                                                   sends a "carriage
  3732.                                                   return", as though you
  3733.                                                   had pressed <Enter> on
  3734.                                                   the keyboard.
  3735.  
  3736.           ^[ ("caret" sign and left bracket "[")  This character sequence
  3737.                                                   sends <Esc> as though you
  3738.                                                   had pressed <Esc> on the
  3739.                                                   keyboard.
  3740.  
  3741.           ~ (tilde) -                             This character causes a
  3742.                                                   100 millisecond delay.
  3743.           2.2  Script Functions
  3744.  
  3745.             The next section describes the various script functions that
  3746.           are available.
  3747.  
  3748.  
  3749.           2.2.1  Labels
  3750.  
  3751.             Labels are used to produce logical execution branches within
  3752.           the script file.  Labels are used with the GOTO(<label>) function
  3753.           as well as several other functions which will branch when a
  3754.           condition is met.
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.           2.2.2  WAITFOR()
  3762.  
  3763.           format: WAITFOR(int waitsecs, "string"|Sn, (optional) "label"|Sn)
  3764.  
  3765.           WAITFOR() will wait up to <int> seconds for <string> and goto
  3766.           <label> if the <string> is received.  If the <string> is not
  3767.           received the next line in the script is executed.  Note that
  3768.           <label> is optional in which case the next line in the script
  3769.           would be executed regardless.
  3770.  
  3771.           For example if you wanted to wait 30 seconds for the string
  3772.           "PassWord" then jump to the label :GotPass
  3773.  
  3774.                WAITFOR(30, "PassWord", "GotPass")
  3775.  
  3776.           would do it.
  3777.  
  3778.  
  3779.           2.2.3  XMIT()
  3780.  
  3781.           format: XMIT("string"|Sn)
  3782.  
  3783.           Transmit a "string".  For example:
  3784.  
  3785.                XMIT("password")
  3786.  
  3787.           would send the string "password".
  3788.             If the LOCLECHO() function has been set to "Yes" the characters
  3789.           sent by XMIT() will also be shown on your local screen.  This may
  3790.           be useful when the other system is not echoing characters back to
  3791.           you.
  3792.  
  3793.  
  3794.           2.2.4  GOTO()
  3795.  
  3796.           format: GOTO("label"|Sn)
  3797.  
  3798.           Jump to :label.  For example, if you have the label ":Lab001" in
  3799.           your script, GOTO("Lab001") would jump to that label.  Script
  3800.           execution resumes at the line after the label.
  3801.  
  3802.  
  3803.           2.2.5  SETFLAG()
  3804.  
  3805.           format: SETFLAG(In, int value)
  3806.  
  3807.           Set integer flag to a value.  The flags are referenced as flag 0
  3808.           through 9.  The flags can take on values between -999 and 9999.
  3809.           This function has the following format:
  3810.  
  3811.           For example to set flag 1 to 42:
  3812.  
  3813.                SETFLAG(I1, 42)
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.           2.2.6  INCFLAG()
  3822.  
  3823.           format: INCFLAG(In)
  3824.  
  3825.             The flags that were set (see SETFLAG() above) may be
  3826.           incremented by 1.  To increment flag 1:
  3827.  
  3828.                INCFLAG(I1)
  3829.  
  3830.  
  3831.           2.2.7  DECFLAG()
  3832.  
  3833.           format: DECFLAG(In)
  3834.  
  3835.             The flags that were set (see SETFLAG() above) may be
  3836.           decremented by 1.  To decrement flag 1:
  3837.  
  3838.                DECFLAG(I1)
  3839.  
  3840.  
  3841.           2.2.8  IFFLAG()
  3842.  
  3843.           format: IFFLAG(In, <EQ|GT|LT|GE|LE|NE>, int value, "label"|Sn)
  3844.  
  3845.             The integer flags may be tested for logical conditions.  If the
  3846.           condition is met script execution continues at the statement
  3847.           following the label.  The test condition operators are:
  3848.  
  3849.                EQ - equal
  3850.                GT - greater than
  3851.                LT - less than
  3852.                GE - greater than or equal
  3853.                LE - less than or equal
  3854.                NE - not equal
  3855.  
  3856.           If you wanted to test to see if flag 1 was EQual to 42, then jump
  3857.           to label :Lab001 you would enter:
  3858.  
  3859.                IFFLAG(I1, EQ, 42, "Lab001")
  3860.  
  3861.           NOTE: Quote characters are not used around the operators.
  3862.  
  3863.  
  3864.           2.2.9  IFSCAN()
  3865.  
  3866.           format: IFSCAN(Sn, "string"|Sn, "label"|Sn)
  3867.  
  3868.             You may set up to ten scan strings to continuously scan for.
  3869.           When the scan condition is met script execution continues at the
  3870.           statement following the label.  For example if you wanted to scan
  3871.           for the string "John Doe" and then jump to the label :Lab001 when
  3872.           it was found:
  3873.  
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.                IFSCAN(S1, "John Doe", "Lab001")
  3881.  
  3882.           IFSCAN() recognizes S0 through S9 as valid flag names.  The
  3883.           IFSCAN() function can be reset to scan for a new string by re-
  3884.           using the string variable. For example:
  3885.  
  3886.                IFSCAN(S1, "Bob Public", "Lab001")
  3887.  
  3888.  
  3889.           2.2.10 SENDNAME()
  3890.  
  3891.           format: SENDNAME()
  3892.  
  3893.             The SENDNAME() function will send the name that you have
  3894.           defined in your dialing directory entry for the BBS that the
  3895.           script is "Joined" to.  SENDNAME() take no parameters.  If the
  3896.           name entry in the dialing directory is blank nothing is sent.
  3897.  
  3898.  
  3899.           2.2.11 SENDPASS()
  3900.  
  3901.           format: SENDPASS()
  3902.             The SENDPASS() function will send the password that you have
  3903.           defined in the dialing directory entry for the BBS that the
  3904.           script is "Joined" to.  SENDPASS() take no parameters.  If the
  3905.           password entry in the dialing directory is blank nothing is sent.
  3906.  
  3907.  
  3908.           2.2.12 SENDFILE()
  3909.  
  3910.           format: SENDFILE(<op> A|S|X|K|Y|G|Z, "filename"|Sn,
  3911.                   optional "path"|Sn)
  3912.  
  3913.             The SENDFILE() function is used to upload a file to the host
  3914.           system.  You will have to take care of any preparatory steps
  3915.           within the script, such as telling the host that you are sending
  3916.           a file.
  3917.  
  3918.             The parameters are a one letter designator for the protocol,
  3919.           and a "string" or string flag (S0..S9) for the filename.  By
  3920.           default MyComm looks for the file that you are sending in the
  3921.           "Upload Directory" that you have defined in MyComm.  You may
  3922.           specify a different directory path as the third parameter.
  3923.  
  3924.  
  3925.  
  3926.  
  3927.  
  3928.  
  3929.  
  3930.             The valid operators for <op> are:
  3931.  
  3932.                A - ASCII
  3933.                S - SEAlink
  3934.                X - Xmodem
  3935.                K - Xmodem-1K
  3936.                Y - Ymodem Batch
  3937.                G - Ymodem-G
  3938.                R - Kermit
  3939.                Z - Zmodem
  3940.  
  3941.           For example if you wanted to send the file "MYCOMM.ARC" using
  3942.           Zmodem:
  3943.  
  3944.                SENDFILE(Z, "MyComm.ARC")
  3945.                          - or -
  3946.                SENDFILE(Z, "MyComm.ARC", "MYPATH")
  3947.  
  3948.  
  3949.           2.2.13 RECVFILE()
  3950.  
  3951.           format: RECVFILE(<op> A|S|X|K|Y|G|Z, optional "filename"|Sn,
  3952.                   optional "path"|Sn)
  3953.  
  3954.             RECVFILE() allows you to receive files from the host system.
  3955.           You will have to take care of any preparatory steps within the
  3956.           script, such as telling the host that you want to receive a file.
  3957.  
  3958.           See SENDFILE() (above) for the list of valid operators.  By
  3959.           default the received files are put into the "Download" directory
  3960.           defined in MyComm, however files may be put into a different
  3961.           directory by using the third optional parameter.
  3962.  
  3963.           For example if you wanted to download the file "STUFF.ARC" using
  3964.           Xmodem:
  3965.  
  3966.                RECVFILE(X, STUFF.ARC)
  3967.                          - or -
  3968.                RECVFILE(X, "MyComm.ARC", "MYPATH")
  3969.  
  3970.           Please note that SEAlink, Ymodem, Ymodem-G, and Zmodem do not
  3971.           require that a filename be specified.  These protocols send the
  3972.           filename in a special header.  The ASCII, Xmodem, and Xmodem-1K
  3973.           protocols always require that a filename is specified.
  3974.  
  3975.             NOTE: if you have the Zmodem "Auto Download" feature turned on
  3976.           there may be conflicts between the script Zmodem and the MyComm
  3977.           Zmodem.  If you have the Zmodem "Auto Download" feature turned on
  3978.           in MyComm the Zmodem file transfer will start automatically, and
  3979.           you will not need to use this function during Zmodem downloads.
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.           2.2.14 SNDBREAK()
  3987.  
  3988.           format: SNDBREAK(optional <int ms>)
  3989.  
  3990.             SNDBREAK() sends a "Break" signal for 1500 milliseconds.  It
  3991.           will also take an optional parameter for the number of
  3992.           milliseconds that the "Break" signal will be sent.
  3993.  
  3994.  
  3995.           2.2.15 ALARM()
  3996.  
  3997.           format: ALARM(optional <int ms>)
  3998.  
  3999.             ALARM() will make a noise for <int> milliseconds.  For example
  4000.           ALARM(1000) would sound a beep for one second.  The default alarm
  4001.           duration is 500 milliseconds (1/2 second).
  4002.  
  4003.  
  4004.           2.2.16 PAUSE()
  4005.  
  4006.           format: PAUSE(int seconds)
  4007.  
  4008.             PAUSE() will cause a delay for "seconds" seconds.  For example
  4009.           PAUSE(5) would pause the script for 5 seconds.
  4010.  
  4011.  
  4012.           2.2.17 HANGUP()
  4013.  
  4014.           format: HANGUP()
  4015.  
  4016.             The HANGUP() function causes the modem to disconnect.  HANGUP()
  4017.           uses the information from the MyComm configuration file to send
  4018.           the correct hang up string.
  4019.  
  4020.  
  4021.           2.2.18 IGNORECD()
  4022.  
  4023.           format: IGNORECD("Yes"|"No"|Sn)
  4024.  
  4025.             This function "Ignore Carrier Detect" tells the script
  4026.           processor to ignore the state of the "Carrier Detect" modem
  4027.           signal.  By default if the carrier signal is lost the script
  4028.           exits.  In some cases, such as while waiting for an incoming
  4029.           call, it is useful for the script to continue execution even when
  4030.           there is no carrier signal.
  4031.  
  4032.             This function takes one parameter: a string of "Yes" or "No",
  4033.           or one the string variables (S0..S9).  A value of "Yes" turns off
  4034.           carrier detect monitoring within the script, "No" turns
  4035.           monitoring back on.
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.           2.2.19 SETSTR()
  4043.  
  4044.           format: SETSTR(Sn, "string"|Sn)
  4045.  
  4046.           SETSTR() sets one of the string variables S0 through S9 to a
  4047.           string constant or another string variable.  For example:
  4048.  
  4049.                SETSTR(S2, "This String")
  4050.  
  4051.           would set string variable S2 to "This String".
  4052.  
  4053.             Please note that the SETSTR() function resets the "goto" label
  4054.           of the string variable if that same string variable was
  4055.           previously assigned with the IFSCAN() function.
  4056.  
  4057.           2.2.20 GOSUB()
  4058.  
  4059.           format: GOSUB("label"|Sn)
  4060.  
  4061.             The GOSUB() function is used to branch execution in the script.
  4062.           It is similar to the GOTO() function except that later in the
  4063.           script a RETURN() function may be used which will transfer script
  4064.           execution to the statement following the last GOSUB().  For
  4065.           example:
  4066.  
  4067.                GOSUB("gosub1")     ; go to label "gosub1"
  4068.                <statement1>        ; execution resumes here after RETURN()
  4069.                <statement2>
  4070.                     ...
  4071.                <statement-n>
  4072.  
  4073.                :gosub1             ; label for GOSUB() to go to
  4074.                <statement1>
  4075.                <statement2>
  4076.                     ...
  4077.                <statement-n>
  4078.                RETURN()            ; return to statement after GOSUB()
  4079.  
  4080.  
  4081.           2.2.21 RETURN()
  4082.  
  4083.           format: RETURN()
  4084.  
  4085.             The RETURN() function returns script execution to the statement
  4086.           following the most recent GOSUB().  See the description of the
  4087.           GOSUB() function above for details.
  4088.  
  4089.           2.2.22 EXIT()
  4090.  
  4091.           format: EXIT()
  4092.  
  4093.             The EXIT() function exits the script and return control back to
  4094.           MyComm.
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.           2.2.23 QUIT()
  4102.  
  4103.           format: QUIT()
  4104.  
  4105.             The QUIT() function exits from the script and MyComm
  4106.           completely.  Please note: QUIT() does not hang up the modem. If
  4107.           you would like the modem to disconnect the HANGUP() function
  4108.           should be used before QUIT().
  4109.  
  4110.  
  4111.           2.2.24 COMPSTR()
  4112.  
  4113.           format: COMPSTR("string"|Sn, "string"|Sn, "label"|Sn)
  4114.  
  4115.             The COMPSTR() function compares two strings or string variables
  4116.           and jumps to a label if the strings are equal.  The comparison is
  4117.           not case sensitive.
  4118.  
  4119.  
  4120.           2.2.25 LOCLECHO()
  4121.  
  4122.           format: LOCLECHO("Y"|"N")
  4123.  
  4124.             This function turns the local echo on during script execution.
  4125.           When the local echo is on anything sent with the XMIT() function
  4126.           is echoed back to the local console.  Additionally the PORTGET()
  4127.           function (see below) echoes characters back to the other system.
  4128.  
  4129.           2.2.26 IF()
  4130.  
  4131.           format: IF("TRANSTAT"|"CARDET"|"NOCARDET"|"SUCCESS", "label"|Sn)
  4132.  
  4133.             The IF() function tests one of the MyComm internal script flags
  4134.           for a TRUE condition and then jumps to a label if TRUE.  The
  4135.           internal script flags are:
  4136.  
  4137.                TRANSTAT - True if last file transfer was successful
  4138.                CARDET   - True if carrier detected
  4139.                NOCARDET - True if no carrier detected
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.           2.2.27 PORTGET()
  4148.           PORTGET()
  4149.  
  4150.           format: PORTGET(Sn, len, waittime)
  4151.  
  4152.             The PORTGET() function waits up to "waittime" seconds to get up
  4153.           to "len" characters from the COM port and put them into a string
  4154.           variable.  If the LOCLECHO() function has been activated the
  4155.           characters are echoed back to the other system.  This would be
  4156.           useful for getting responses from someone who is calling you for
  4157.           example.  Note: only printable ASCII characters in the range of
  4158.           20 hex to 7E hex (Space char through tilde) will be placed into
  4159.           the string variable.  Also note that receiving a "carriage
  4160.           return" character (0D hex) will cause PORTGET() to exit with
  4161.           whatever characters were received up to that point.
  4162.  
  4163.  
  4164.  
  4165.  
  4166.  
  4167.  
  4168.           3.0  Script Syntax Checker
  4169.  
  4170.             The program SCP_CHK.EXE is used for checking the syntax of
  4171.           script files.  To use the program to check a script file type:
  4172.  
  4173.                SCP_CHK SCRIPT.SCP
  4174.  
  4175.           Replace SCRIPT.SCP with your file name.  Also the .SCP extension
  4176.           is assumed and you may leave it off if you like.  The output from
  4177.           SCP_CHK will be display on the screen, or you may redirect the
  4178.           output to a file.  For example
  4179.  
  4180.                SCP_CHK MYSCRIPT > MYSCRIPT.OUT
  4181.  
  4182.           would create the file MYSCRIPT.OUT with all the error
  4183.           information.  This might prove useful if you have a long error
  4184.           list.
  4185.  
  4186.             The output from SCP_CHK will look something like this:
  4187.  
  4188.                Line 3  ALARM  - Error  : too few arguments
  4189.  
  4190.             This shows you the line number where the error occurred, the
  4191.           function that caused the error, and the reason why it was an
  4192.           error.  The error messages are self explanatory.  Simply re-edit
  4193.           the script file and correct any errors.  Run SCP_CHK again to
  4194.           make sure that you caught all the errors.
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.           4.0  Script Sample
  4202.  
  4203.             This is a sample of a working script file that picks up mail at
  4204.           a local BBS.
  4205.  
  4206.           waitfor(180, "=no change?")              ;get past opening screen
  4207.           xmit("^M")
  4208.           waitfor(30, "Do you want graphics")
  4209.           xmit("Y^M")
  4210.  
  4211.           waitfor(30, "your first name?")          ;login
  4212.           sendname()
  4213.           waitfor(30, "Is this correct?")
  4214.           xmit("Y^M)
  4215.           waitfor(30, "Password")
  4216.           sendpass()
  4217.  
  4218.           waitfor(180, "Scan Message Base")        ;get past local msgs
  4219.           xmit("N^M")
  4220.  
  4221.           waitfor(15,"Press (Enter) to continue?", jump1)
  4222.           goto("nojump1")
  4223.           :jump1
  4224.           xmit("^M")
  4225.           :nojump1
  4226.           ;at main menu now...
  4227.           waitfor(60, "Command?")
  4228.           xmit("open^M")                           ;get to door section
  4229.  
  4230.           waitfor(30, "Enter the DOOR # to Open")  ;open mail door
  4231.           xmit("3^M)
  4232.           waitfor(60, "mail Command?")
  4233.           xmit("D^M")                              ;start mail gathering
  4234.           waitfor(600, "receive these messages")
  4235.           xmit("G^M")                              ;start mail d/l
  4236.           ;zmodem will auto start here
  4237.                                                    ;download complete
  4238.           waitfor(60, "Thank you for visiting")    ;now logoff
  4239.           hangup()
  4240.           exit()                                   ;exit the script
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.           Appendix F - MyComm Order Form
  4249.  
  4250.                            MyComm Version 2.23  Order Form
  4251.                       Copyright (c) 1992 - 1994 - Ken Dorshimer
  4252.                                  All Rights Reserved
  4253.  
  4254.                                       Mail to:
  4255.                                     Ken Dorshimer
  4256.                                     P.O. Box 5143
  4257.                                  Belmont, Ca. 94002
  4258.  
  4259.  
  4260.           Your Name: _________________________________________________
  4261.  
  4262.           Address:   _________________________________________________
  4263.  
  4264.                      _________________________________________________
  4265.  
  4266.           City:      _________________________________________________
  4267.  
  4268.  
  4269.           State:    _________      Zip Code: _________________________
  4270.  
  4271.           Disk Format: 5.25" floppy ____   OR  3.5" semi-floppy ____
  4272.  
  4273.  
  4274.           Number of Copies of MyComm  _______  X $25.00 =   __________
  4275.  
  4276.           Number of Copies of MyComm  _______  X $2 S&H = + __________
  4277.               (NOTE: S&H is $3 outside of the United States)
  4278.  
  4279.                                                 Total:      __________
  4280.  
  4281.  
  4282.           Please make check or Money Order payable to Ken Dorshimer, and
  4283.           send to the address above (mine not yours).
  4284.  
  4285.           Funds should be in U.S dollars, and drawn on a U.S. bank.
  4286.  
  4287.             (Please send check or money order, do not send cash.  People
  4288.           who want to order MyComm from outside the U.S. should obtain a
  4289.           money order in U.S. dollars from a local bank).
  4290.  
  4291.             Please note: I am not able to process credit card orders at
  4292.           this time (several folks have asked me about this).
  4293.  
  4294.  
  4295.  
  4296.  
  4297.  
  4298.  
  4299.           Appendix G - MyComm Bug Report Form
  4300.  
  4301.                         MyComm Version 2.23  Bug Report Form
  4302.  
  4303.             This form may be used to describe any problems, or bugs that
  4304.           you may have found with MyComm.  You may also use it to describe
  4305.           any enhancements you would like to see added to MyComm, or
  4306.           suggestions for future versions.
  4307.  
  4308.             Bug reports and suggestions are always welcome.  Of course all
  4309.           bug reports and suggestions get much closer scrutiny when
  4310.           accompanied by a registration check <grin>.
  4311.  
  4312.           ----------------------------------------------------------
  4313.  
  4314.           Machine Type __________________________     DOS Version ____
  4315.  
  4316.           Machine BIOS Type _____________________     Monitor ________
  4317.  
  4318.           Modem Brand __________________________      Speed     ______
  4319.  
  4320.           Describe problem, bug, or suggestion:
  4321.  
  4322.           ____________________________________________________________
  4323.           ____________________________________________________________
  4324.           ____________________________________________________________
  4325.           ____________________________________________________________
  4326.           ____________________________________________________________
  4327.           ____________________________________________________________
  4328.           ____________________________________________________________
  4329.           ____________________________________________________________
  4330.           ____________________________________________________________
  4331.           ____________________________________________________________
  4332.           ____________________________________________________________
  4333.           ____________________________________________________________
  4334.           ____________________________________________________________
  4335.           ____________________________________________________________
  4336.           ____________________________________________________________
  4337.           ____________________________________________________________
  4338.           ____________________________________________________________
  4339.           ____________________________________________________________
  4340.           ____________________________________________________________
  4341.           ____________________________________________________________
  4342.  
  4343.  
  4344.                                       Mail To:
  4345.                                     Ken Dorshimer
  4346.                                     P.O. Box 5143
  4347.                                  Belmont, Ca. 94002
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.           Appendix H - Planned Modifications and Upgrades
  4355.  
  4356.             At this time I am planning (contingent on the number of
  4357.           registrations of MyComm) to make several modifications and
  4358.           upgrades to MyComm.  Some of these are:
  4359.  
  4360.  
  4361.                  ■  MS-Windows (Tm) and/or Deskview (Tm)
  4362.                     compatibility
  4363.  
  4364.                  ■  Compuserve-B file transfer protocol
  4365.  
  4366.                  ■  VT-200 Terminal Emulation (as well as some other ones
  4367.                     people have been asking about)
  4368.  
  4369.                  ■  Script Language enhancements
  4370.  
  4371.             Of course upgrades are dependent on you, the end user.  MyComm
  4372.           is user supported software.  If I see that people are interested
  4373.           in the program, and interested enough to register it, I will feel
  4374.           more inclined to continue to perform upgrades to MyComm.
  4375.  
  4376.             The creation and development of a program like MyComm is by no
  4377.           means trivial.  Continued user support in the form of
  4378.           registrations gives me, your humble author, the incentive to keep
  4379.           upgrading and improving MyComm.
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.           Appendix I - MyComm Revision History
  4387.  
  4388.           Note: Past versions of this section had every nuance of every
  4389.           enhancement or bug fix listed.  I have decided to only list the
  4390.           enhancements that pertain to the current major release for
  4391.           brevity.
  4392.  
  4393.           September 19, 1991  - MyComm Version 1.0 design began
  4394.           February 16, 1992   - MyComm Version 1.0 completed
  4395.           March 18, 1992      - MyComm Version 1.10 completed
  4396.           April 11, 1992      - MyComm Version 1.20 completed
  4397.           May 9, 1992         - MyComm Version 1.22 completed
  4398.           April 8, 1993       - MyComm Version 2.0 (Major revision)
  4399.           June 19, 1993       - MyComm Version 2.01 (Bug fix)
  4400.           July 7, 1993        - MyComm Version 2.02 (Bug fix)
  4401.           August 8, 1993      - MyComm Version 2.1 (Enhancement)
  4402.           November 11, 1993   - MyComm Version 2.11 (Maintenance release)
  4403.           Nov. 93 - Jan 94    - MyComm Versions 2.12 - 2.14
  4404.                                 were "registered" releases only
  4405.           January 3, 1994     - MyComm Version 2.15 (Enhancement)
  4406.           March 28, 1994      - MyComm Version 2.21 (Enhancement)
  4407.           May 8, 1994         - MyComm Version 2.22 (Maintenance release)
  4408.           June 20, 1994       - MyComm Version 2.23 (Maintenance release)
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.           Appendix J - Control Characters
  4416.  
  4417.             MyComm supports the sending of standard data communications
  4418.           control characters.  Control characters are preceded by the caret
  4419.           character '^'.  The caret denotes that the next character will be
  4420.           a control character.  For example ^M is the symbol for Carriage
  4421.           Return or <Enter> which could be used to terminate your "Modem
  4422.           Initialization String".  The '^' stands for Ctrl, so sending one
  4423.           of these sequences would be similar to pressing the <Ctrl> key
  4424.           and the character 'M' simultaneously.  The control characters are
  4425.           especially useful when using the script language functions. For
  4426.           example ^[  represents the ESCape character which is often used
  4427.           to start a session on a BBS.
  4428.  
  4429.            Please note that these control sequences are only interpreted by
  4430.           MyComm when you are sending a string such as your "Modem
  4431.           Initialization String", "Hangup String", etc. or with the XMIT()
  4432.           function in the script language.  A listing of commonly used
  4433.           control characters follows.
  4434.  
  4435.           Sequence       Meaning
  4436.  
  4437.           ^@             NUL
  4438.           ^A             SOH
  4439.           ^B             STX
  4440.           ^C             ETX
  4441.           ^D             EOT
  4442.           ^E             ENQuire
  4443.           ^F             ACKnowledge
  4444.           ^G             BELL
  4445.           ^H             BackSpace
  4446.           ^I             TAB
  4447.           ^J             Line Feed
  4448.           ^L             Form Feed
  4449.           ^M             Carriage Return (Enter key)
  4450.           ^P             DLE
  4451.           ^Q             XON
  4452.           ^S             XOFF
  4453.           ^U             NAK
  4454.           ^V             SYN
  4455.           ^X             CANcel (often used for aborting file transfers)
  4456.           ^Z             SUB (also end of file)
  4457.           ^[             ESCape
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.           -D (Dial Command Line Parameter)  12
  4466.           -J (Join Script Command Line Parameter)  12
  4467.           -T (Timed Start Command Line Parameter)  13
  4468.           1K-Xmodem File Transfers  54
  4469.           3270 Terminal Emulation  62
  4470.           Add LF after incoming CR  21
  4471.           Add Phone List Item  17
  4472.           ALARM()  74
  4473.           Alt A  15
  4474.           Alt B  16
  4475.           Alt C  16
  4476.           Alt D  16
  4477.           Alt E  25
  4478.           Alt F  25
  4479.           Alt H  26
  4480.           Alt I  26
  4481.           Alt K  27
  4482.           Alt L  26
  4483.           Alt M  27
  4484.           Alt O  28
  4485.           Alt P  28
  4486.           Alt Q  29
  4487.           Alt R  29
  4488.           Alt S  29
  4489.           Alt T  30
  4490.           Alt U  30
  4491.           Alt W  48
  4492.           Alt X  48
  4493.           ANSI Terminal Emulation  60
  4494.           ASCII File Transfers  53
  4495.           ASCII Transfers Setup  38
  4496.           ASCII Transfers Setup Screen  39
  4497.           Baud Rate  18
  4498.           BS Key Sends BS or DELete  20
  4499.           Call Numbers (Dial)  22
  4500.           Caret Sign  84
  4501.           Change Port Parameters - Alt P  28
  4502.           Change Port Parameters Screen  28
  4503.           Character Pace Time  40
  4504.           Chat Mode - Alt A  15
  4505.           Clear last date called  21
  4506.           Clear the Screen - Alt C  16
  4507.           Clever quip for TagLine  47
  4508.           COM Port  31
  4509.           COM Port Addresses  47
  4510.           Command Line Parameters  12
  4511.           Command Summary  58
  4512.           COMPSTR()  76
  4513.           Connect Strings  36
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.           Control Characters  84
  4521.           CR Translation Upload and Download  39
  4522.           Data Bits  18
  4523.           Data Parity  18
  4524.           Date Format Style  45
  4525.           DECFLAG()  71
  4526.           Default Protocol  19
  4527.           Definitions, Acronyms  5
  4528.           Delete an Item  22
  4529.           Dial Entries  12
  4530.           Dial Prefix  19
  4531.           Dial Screen  16
  4532.           Dialing Functions - Alt D  16
  4533.           Dialing Prefix #1  35
  4534.           Dialing Prefix #2  35
  4535.           Dialing Prefix #3  35
  4536.           Dialing Prefixes  35
  4537.           Dialing Status Window  22
  4538.           Dialing Wait Time  33
  4539.           Disclaimer and Warranty  5
  4540.           Download Directory Path  37
  4541.           Download Files - PgDn  53
  4542.           Download Protocol Menu  51
  4543.           Download/Upload Status Window  52
  4544.           Edit Phone List Item Screen  17
  4545.           Editor Path\Filename  37
  4546.           Exit MyComm - Alt X  48
  4547.           EXIT()  75
  4548.           Expand Blank Lines to Spaces  40
  4549.           External Programs Path\Filename  38
  4550.           External Protocol File Transfers  56
  4551.           External Protocols Setup  43
  4552.           External Protocols Setup Screen  43
  4553.           F1 key  14, 48
  4554.           F2 key  49
  4555.           F3 key  49
  4556.           F4 key  49
  4557.           File Transfer Hints  53
  4558.           Filename Guessing  47
  4559.           Find Phone List Items  24
  4560.           General System Requirements  6
  4561.           GOSUB()  75
  4562.           GOTO()  70
  4563.           Guess Filename  47
  4564.           Guess Up/Download Filename  47
  4565.           Hang Up Modem - Alt H  26
  4566.           HANGUP()  74
  4567.           Help Menu - F1  14
  4568.           Help Screen  15
  4569.           Help Screen - F1  48
  4570.  
  4571.  
  4572.  
  4573.  
  4574.  
  4575.  
  4576.           High speed modem  32
  4577.           IF()  76
  4578.           IFFLAG()  71
  4579.           IFSCAN()  71
  4580.           Ignore Carrier Detect  74
  4581.           IGNORECD()  74
  4582.           INCFLAG()  71
  4583.           Installation  8, 9
  4584.           Introduction to MyComm  1
  4585.           Join Script  12
  4586.           Join Script - Alt J  26
  4587.           Kermit File Transfers  56
  4588.           Kermit Transfers Setup  42
  4589.           LF Translation Upload and Download  40
  4590.           Line Editing Functions  59
  4591.           Line Feeds On/Off - Alt F  25
  4592.           Line Pace Time  40
  4593.           Load Phone List Screen  24
  4594.           Local Echo  20
  4595.           Local Echo on by Default  34
  4596.           Local Echo On During ASCII Uploads  40
  4597.           Local Echo On/Off - Alt E  25
  4598.           LOCLECHO()  76
  4599.           Logon Name  19
  4600.           Make Noise After File Transfers  46
  4601.           Make Noise When Calls Connect  46
  4602.           Manual Dial - Alt M  27
  4603.           Manual Dial Screen  23
  4604.           Manual Dial Window  23
  4605.           Mark Phone List Items  24
  4606.           Miscellaneous Options Setup  44
  4607.           Miscellaneous Options Setup Screen  45
  4608.           Modem Answer String  33
  4609.           Modem Attention String  32
  4610.           Modem Cancel Dial String  33
  4611.           Modem Dial Suffix String  33
  4612.           Modem Hang Up String  32
  4613.           Modem Initialization String  32
  4614.           Modem Setup Screen  30, 31
  4615.           Move Phone List Item  25
  4616.           MyComm as a Host  56
  4617.           MyComm Bug Report Form  81
  4618.           MyComm Command Summary  58
  4619.           MyComm Files  7
  4620.           MyComm Installation  8
  4621.           MyComm Line Editing Functions  59
  4622.           MyComm Order Form  80
  4623.           MyComm Registration and Licensing  2
  4624.           MyComm Revision History  83
  4625.           MyComm Screens and Menus  13
  4626.           Name  17
  4627.           Number  18
  4628.  
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.           Order Form  80
  4635.           Outside to DOS - Alt O  28
  4636.           Pacing Char  41
  4637.           Page Down  53
  4638.           Page Up  53
  4639.           Password  19
  4640.           Password for sign on  46
  4641.           Paths Setup  36
  4642.           Paths Setup Screen  36
  4643.           Pause Between Calls  34
  4644.           PAUSE()  74
  4645.           PgDn  53
  4646.           PgUp  53
  4647.           Phone File Path\File  37
  4648.           Phone Item Info Screen  23
  4649.           PORTGET()  77
  4650.           Present Line Status - Alt L  26
  4651.           Present Line Status Window  27
  4652.           Print Phone List  25
  4653.           Protocols Setup  38
  4654.           Protocols Setup Menu  38
  4655.           Quick Re-Dial - Alt Q  29
  4656.           QUIT()  76
  4657.           Received BS (BackSpace) Destructive  20
  4658.           RECVFILE()  73
  4659.           Remote Abort Char  39
  4660.           Restore to Defaults  48
  4661.           RETURN()  75
  4662.           Revision History  83
  4663.           Run External Program - Alt R  29
  4664.           Save Changes  21
  4665.           Save Setup  48
  4666.           SCP Files  68
  4667.           SCP_CHK.EXE  78
  4668.           Screen Background Color  45
  4669.           Screen Capture Path\File  37
  4670.           Screen Text Color  45
  4671.           Screen Width  66
  4672.           Screens and Menus  13
  4673.           Script - Dialing Entry  21
  4674.           Script, creating  67
  4675.           Script Labels  69
  4676.           Script Language  67, 68
  4677.           Script Sample  79
  4678.           Script Syntax Checker  78
  4679.           Scripts, Special Characters  69
  4680.           Scroll Back - Alt K  27
  4681.           SEAlink Derived File Transfers  54
  4682.           Send Break - Alt B  16
  4683.           Send Init. String Menu  26
  4684.           Send Modem Initialization Strings - Alt I  26
  4685.           Send Name - F2  49
  4686.  
  4687.  
  4688.  
  4689.  
  4690.  
  4691.  
  4692.           Send Password - F3  49
  4693.           Send Screen to File - Alt W  48
  4694.           Send Tagline  - F4  49
  4695.           SENDFILE()  72
  4696.           SENDNAME()  72
  4697.           SENDPASS()  72
  4698.           Session Capture On/Off/Pause - Alt S  29
  4699.           Session Capture Path\File  37
  4700.           SETFLAG()  70
  4701.           SETSTR()  75
  4702.           SNDBREAK()  74
  4703.           Sort Phone List  24
  4704.           Starting a File Transfer  50
  4705.           Stop Bits  18
  4706.           Strip Hi Bits  21
  4707.           Strip High Bits  39
  4708.           System Requirements  8
  4709.           Terminal Emulation - Alt T  30
  4710.           Terminal Screen  14
  4711.           Terminal Type  20
  4712.           Time Format - 12 or 24 Hour  45
  4713.           Timed Start  13
  4714.           Transferring Files  49
  4715.           Troubleshooting  63
  4716.           TTY Terminal Emulation  60
  4717.           Update Configuration - Alt U  30
  4718.           Update Configuration Menu  30
  4719.           Upload Directory Path  37
  4720.           UpLoad Files - PgUp  53
  4721.           Use CTS/RTS Flow Control  35
  4722.           Use Direct Video  46
  4723.           Use DSR/DTR Flow Control  35
  4724.           Use DTR to Hang Up Modem  34
  4725.           Use XON/XOFF Flow Control  34
  4726.           VT-100 Terminal Emulation  61
  4727.           VT-52 Terminal Emulation  61
  4728.           WAITFOR()  70
  4729.           Word wrap  66
  4730.           XMIT()  70
  4731.           Xmodem File Transfers  54
  4732.           Xmodem-1K  54
  4733.           Ymodem  54
  4734.           Ymodem Batch - 1K  55
  4735.           Ymodem Batch File Transfers  55
  4736.           Ymodem-G Batch  55
  4737.           Your Name for sign on  46
  4738.           Zmodem 32 Bit CRC  41
  4739.           Zmodem Auto Download Feature  41
  4740.           Zmodem File Transfers  55
  4741.           Zmodem Receive Crash Recovery  42
  4742.           Zmodem Send Crash Recovery  41
  4743.           Zmodem Transfers Setup  41